了解新的 Picker API 和重要的 Library API 变更。如需了解详情,请点击
此处。
Method: sessions.get
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
检索指定会话的相关信息。
如果指定的会话不存在或不归用户所有,则会返回 NOT_FOUND
错误。如果会话存在,但对会话的访问权限已过期,则会返回 PERMISSION_DENIED
错误。
HTTP 请求
GET https://photospicker.googleapis.com/v1/sessions/{sessionId}
网址采用 gRPC 转码语法。
路径参数
参数 |
sessionId |
string
必需。Google 为此会话生成的标识符。
|
响应正文
如果成功,则响应正文包含一个 PickingSession
实例。
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/photospicker.mediaitems.readonly
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[[["\u003cp\u003eRetrieves details about a specific photo picking session using its unique identifier.\u003c/p\u003e\n"],["\u003cp\u003eReturns a \u003ccode\u003eNOT_FOUND\u003c/code\u003e error if the session doesn't exist or isn't owned by the user, and a \u003ccode\u003ePERMISSION_DENIED\u003c/code\u003e error if access has expired.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/photospicker.mediaitems.readonly\u003c/code\u003e scope for accessing session information.\u003c/p\u003e\n"],["\u003cp\u003eProvides the session details in the response body if the request is successful.\u003c/p\u003e\n"]]],["This document outlines the process of retrieving session information via a `GET` request to `https://photospicker.googleapis.com/v1/sessions/{sessionId}`. The `sessionId`, a required string, is provided as a path parameter. The request body must be empty. A successful response returns a `PickingSession` instance, otherwise `NOT_FOUND` or `PERMISSION_DENIED` error. Access requires the `https://www.googleapis.com/auth/photospicker.mediaitems.readonly` OAuth scope. The URL follows gRPC Transcoding syntax.\n"],null,["# Method: sessions.get\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n\nRetrieves information about the specified session.\n\nIf the specified session does not exist or is not owned by the user, a `NOT_FOUND` error is returned. If the session exists but access to the session has expired, a `PERMISSION_DENIED` error is returned.\n\n### HTTP request\n\n`GET https://photospicker.googleapis.com/v1/sessions/{sessionId}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-------------|----------------------------------------------------------------------|\n| `sessionId` | `string` Required. The Google-generated identifier for this session. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [PickingSession](/photos/picker/reference/rest/v1/sessions#PickingSession).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/photospicker.mediaitems.readonly`"]]