Learn about the new Picker API and important Library API changes. Details here
.
Method: sessions.get
Stay organized with collections
Save and categorize content based on your preferences.
Retrieves information about the specified session.
If 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.
HTTP request
GET https://photospicker.googleapis.com/v1/sessions/{sessionId}
The URL uses gRPC Transcoding
syntax.
Path parameters
| Parameters |
sessionId
|
string
Required. The Google-generated identifier for this session.
|
Request body
The request body must be empty.
Response body
If successful, the response body contains an instance of PickingSession
.
Authorization scopes
Requires the following OAuth scope:
-
https://www.googleapis.com/auth/photospicker.mediaitems.readonly
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License
, and code samples are licensed under the Apache 2.0 License
. For details, see the Google Developers Site Policies
. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-03-10 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-03-10 UTC."],[[["\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`"]]
