Method: sessions.create

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

如果用户没有有效的 Google 相册账号,则会返回 FAILED_PRECONDITION 错误。

如果客户端应用为每位用户创建的会话过多,则会返回 RESOURCE_EXHAUSTED 错误。在正常情况下,客户不太可能达到这些限制。不过,我们仍建议客户在每次会话后调用 sessions.delete,以主动确保其始终在资源限制范围内。

HTTP 请求

POST https://photospicker.googleapis.com/v1/sessions

网址采用 gRPC 转码语法。

查询参数

参数
requestId

string

可选。客户端为此请求提供的唯一标识符。

此 ID 用于为使用 OAuth 2.0 流程的应用提供简化选择体验,适用于输入受限的设备。

此 ID 必须采用 UUID(版本 4)字符串格式,并符合以下要求:

  • 不得包含任何与用户相关的敏感身份信息。
  • 必须包含 32 个十六进制字符,分为五组,以连字符分隔,格式为“xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”(或 8-4-4-4-12)。

请求正文

请求正文包含一个 PickingSession 实例。

响应正文

如果成功,响应正文将包含一个新创建的 PickingSession 实例。

授权范围

需要以下 OAuth 范围:

  • https://www.googleapis.com/auth/photospicker.mediaitems.readonly