了解新的 Picker API 和重要的 Library API 变更。如需了解详情,请点击
此处。
Method: sessions.create
生成一个新会话,用户可以在该会话中选择要授予第三方访问权限的照片和视频。
如果用户没有有效的 Google 相册账号,则会返回 FAILED_PRECONDITION
错误。
如果客户端应用为每位用户创建的会话过多,则会返回 RESOURCE_EXHAUSTED
错误。在正常情况下,客户不太可能达到这些限制。不过,我们仍建议客户在每次会话后调用 sessions.delete
,以主动保持在资源限制范围内。
HTTP 请求
POST https://photospicker.googleapis.com/v1/sessions
网址采用 gRPC 转码语法。
请求正文
请求正文包含一个 PickingSession
实例。
响应正文
如果成功,响应正文将包含一个新创建的 PickingSession
实例。
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/photospicker.mediaitems.readonly
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-11-06。
[null,null,["最后更新时间 (UTC):2024-11-06。"],[[["This endpoint creates a session for users to select photos and videos for third-party access."],["A `FAILED_PRECONDITION` error occurs if the user lacks an active Google Photos account."],["Excessive session creation leads to a `RESOURCE_EXHAUSTED` error, though unlikely under normal use."],["Clients should call `sessions.delete` after each session to avoid exceeding resource limits."],["Requires the `https://www.googleapis.com/auth/photospicker.mediaitems.readonly` OAuth scope for authorization."]]],[]]