民意调查

更新

轮询资源包含有关特定数据请求的信息。创建轮询后,它将触发创建一个或多个任务以完成请求。

属性

名称类型描述
id 民意调查ID 资源标识符。
resource 字符串,总是poll 资源类型说明符。
organisation 组织ID 与此资源关联的组织。
key 密钥ID 与此资源关联的密钥。
user 用户身份与此资源关联的用户。
source 来源ID 民意调查所针对的来源。这可以是会话源的子源。
session 会话ID 民意调查正在使用的会话。
subscription 可选的订阅ID 关联的订阅对象ID(如果适用)。
tasks_pending 任务ID列表与正在等待处理的轮询相关联的任务。
tasks_processing 任务ID列表与正在处理的轮询相关联的任务。
tasks_succeeded 任务ID列表与轮询相关的任务已成功完成。
tasks_failed 任务ID列表与轮询相关的任务已失败。
tasks_suspended 任务ID列表与轮询关联的任务被挂起。
results 结果对象列表轮询任务生成的结果对象列表。
state 其中之一: pendingprocessingcompleted
date_created 约会时间资源创建时。
date_started 可选的日期时间当民意调查开始时。
date_completed 可选的日期时间投票处理结束时。

任务

轮询资源的最重要作用是反映其相关任务的进度,并允许最终用户在这些结果可用后立即开始从中获取结果。因此,轮询资源公开了与任务相关的属性,其中,根据任务的状态对相关任务进行了分类。

结果

轮询中运行的任务发布的任何结果都将显示在轮询的results属性中。

状态

轮询状态仅反映轮询是等待初始化( pending ),正在进行( processing )还是所有任务已完成执行( completed )。

除了通过其关联任务之外,轮询不会反映任何错误状态。

有效载荷

轮询有效负载指示应检索哪些类型的信息,数据类型和文件。轮询有效载荷属性架构如下所述。

名称类型描述
info_types info_type对象列表指定应检索的信息类型。支持通配符*
data_types data_type对象列表指定应检索的数据类型。
files file ID列表。 指定要检索的文件。
filters 嵌套filters对象指定要应用于检索到的数据的过滤器。

例如,用于检索iCloud帐户源上所有类型的信息的轮询有效载荷将是:

{
  "info_types": ["*"]
}

要从iCloud备份或重新孵化中继源中检索各种消息传递数据,但仅从特定日期开始:

{
  "data_types": ["ios_messages.messages", "whatsapp.messages", "viber.messages"],
  "filters": {
    "since": "2019-09-15T22:04:12Z"
  }
}

要检索iCloud照片库结果中引用的图像的文件数据,请执行以下操作:

{
  "files": ["icpl://xyz123", "icpl://abc321"]
}

不同的属性也可以同时使用:

{
  "info_types": ["*"],
  "data_types": ["ios_phone.calls"]
}

创建POST /polls

针对特定会话创建针对数据的轮询。

由于会话资源已直接绑定到特定源,因此您不必提供source参数。但是,可以提供指定轮询目标是会话所关联的主源的子源。例如,在iCloud服务上,只能针对iCloud帐户源(iCloud服务的主要来源)创建会话,但您只能通过提供其来定位来自特定iCloud备份(iCloud帐户的子源)的数据。 ID。

名称类型描述
key 可选的密钥ID (可选)覆盖用于此轮询的密钥。这在让用户试用新功能时非常有用。
source 可选,源ID (可选)定位会话链接源的子源。
session 会话ID 用于验证数据检索的会话。
payload 嵌套轮询有效负载用于指定轮询的轮询有效负载

使用cURL

curl https://ricloud-api.reincubate.com/polls \
  -X POST \
  -H 'Authorization: Token <your key_token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "session": "<session ID>",
  "payload": {
    "info_types": ["*"]
  }
}'

使用ricloud-py

import ricloud

poll_payload = {
  'info_types': ['*'],
}

poll = ricloud.Poll.create(
  session='<session ID or ricloud.Session instance>',
  payload=poll_payload,
)

检索GET /polls/{poll ID}

使用cURL

curl https://ricloud-api.reincubate.com/polls/<poll ID> \
  -H 'Authorization: Token <your key_token>'

使用ricloud-py

import ricloud

poll = ricloud.Poll.retrieve(<poll ID>)

列出GET /polls

名称类型描述
key 密钥ID 按关联键过滤。这是用户当时使用的密钥。
user 用户身份按关联用户过滤。
source 来源ID 按目标来源过滤。
session 会话ID 按目标会话过滤。
subscription 订阅编号按关联的订阅进行过滤。
state 按会话状态过滤。
date_created 日期时间过滤器在创建资源时过滤。
date_started 日期时间过滤器轮询开始时的过滤条件。
date_completed 日期时间过滤器在轮询完成时过滤。

使用cURL

curl https://ricloud-api.reincubate.com/polls \
  -H 'Authorization: Token <your key_token>'

使用ricloud-py

import ricloud

polls = ricloud.Poll.list()

我们能帮你什么吗?

我们的支持团队在这里提供帮助!

我们的办公时间是格林威治标准时间周一至周五上午9点至下午5点。 时间目前是 10:37 AM的 GMT。

我们力争在一个工作日内答复所有垂询。

转到支持部分 › 联系企业团队 ›
我们的支持团队非常棒

© 2008 - 2019 Reincubate Ltd. 保留所有权利。 在英格兰和威尔士注册 #5189175, VAT GB151788978. Reincubate®是注册商标。 隐私权和条款. 我们推荐多因素认证。 在伦敦建立了爱情。