REST Resource: sessions

资源：PickingSession

表示用户会话，在此会话期间，用户可以使用 Google 相册选择照片和视频。

JSON 表示法 
{
  "id": string,
  "pickerUri": string,
  "pollingConfig": {
    object (PollingConfig)
  },
  "expireTime": string,
  "mediaItemsSet": boolean
}
字段
id

string

仅限输出。Google 为此会话生成的标识符。
pickerUri

string

仅限输出。用于将用户重定向到 Google 相册（网页版）的 URI，以便用户选择当前会话的照片和视频。

如需成功查看此页面，用户必须在其网络浏览器中登录拥有此会话的 Google 账号。

出于安全原因，pickerUri 无法在 iframe 中打开。
pollingConfig

object (PollingConfig)

仅限输出。应用在轮询 sessions.get 时应使用的建议配置。

只有在尚未为此会话选择媒体内容（即mediaItemsSet 为 false）。
expireTime

string (Timestamp format)

仅限输出。对此会话（及其所选媒体内容）的访问权限到期的时间。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
mediaItemsSet

boolean

仅限输出。如果设置为 true，则表示已为此会话选择了媒体内容，您的应用可以通过 mediaItems.list 请求所选媒体内容的列表。

PollingConfig

用于轮询 API 的配置。

JSON 表示法 
{
  "pollInterval": string,
  "timeoutIn": string
}
字段
pollInterval

string (Duration format)

仅限输出。建议的轮询请求间隔时间。

该时长以秒为单位，最多包含九个小数位，以“s”结尾。示例："3.5s"。
timeoutIn

string (Duration format)

仅限输出。客户端应在多长时间后停止轮询。

值为 0 表示客户端应停止轮询（如果尚未停止）。

该时长以秒为单位，最多包含九个小数位，以“s”结尾。示例："3.5s"。

方法

create

 生成一个新会话，用户可以在该会话中选择要授予第三方访问权限的照片和视频。

delete

 删除指定的会话。

get

 检索指定会话的相关信息。