REST Resource: sessions
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Risorsa: PickingSession
Rappresentazione di una sessione utente durante la quale l'utente può scegliere foto e video utilizzando Google Foto.
| Rappresentazione JSON |
{
"id": string,
"pickerUri": string,
"pollingConfig": {
object (PollingConfig)
},
"expireTime": string,
"pickingConfig": {
object (PickingConfig)
},
"mediaItemsSet": boolean
} |
| Campi |
id |
string
Solo output. L'identificatore generato da Google per questa sessione.
|
pickerUri |
string
Solo output. L'URI utilizzato per reindirizzare l'utente a Google Foto (sul web) in modo che possa scegliere foto e video per la sessione corrente. Per visualizzare questa pagina, l'utente deve aver eseguito l'accesso all'Account Google proprietario di questa sessione nel browser web. pickerUri non può essere aperto in un iframe per motivi di sicurezza.
|
pollingConfig |
object (PollingConfig)
Solo output. La configurazione consigliata che le applicazioni devono utilizzare durante l'esecuzione di polling sessions.get. Questo campo viene compilato solo se non sono stati ancora selezionati elementi multimediali per questa sessione (ad es. mediaItemsSet è falso).
|
expireTime |
string (Timestamp format)
Solo output. Ora di scadenza dell'accesso a questa sessione (e ai relativi elementi multimediali selezionati). Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
|
pickingConfig |
object (PickingConfig)
Facoltativo. Configurazione della scelta delle foto per l'esperienza di scelta dell'utente durante questa sessione. Viene specificato dall'applicazione client quando viene chiamata sessions.create e non può essere modificato in un secondo momento (senza creare una nuova sessione).
|
mediaItemsSet |
boolean
Solo output. Se impostato su true, sono stati selezionati elementi multimediali per questa sessione e la tua applicazione può richiedere l'elenco degli elementi multimediali selezionati tramite mediaItems.list.
|
PollingConfig
Configurazione per l'esecuzione di polling dell'API.
| Rappresentazione JSON |
{
"pollInterval": string,
"timeoutIn": string
} |
| Campi |
pollInterval |
string (Duration format)
Solo output. Tempo consigliato tra le richieste di sondaggio. Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".
|
timeoutIn |
string (Duration format)
Solo output. Il periodo di tempo dopo il quale il client deve interrompere l'polling. Un valore pari a 0 indica che il client deve interrompere l'esecuzione di polling, se non l'ha già fatto. Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".
|
PickingConfig
Configurazione specificata dal cliente per l'esperienza di scelta dell'utente durante questa sessione.
| Rappresentazione JSON |
{
"maxItemCount": string
} |
| Campi |
maxItemCount |
string (int64 format)
Facoltativo. Il numero massimo di articoli che l'utente può scegliere durante questa sessione. Se non specificato, il valore predefinito è 2000. Se non specificato o impostato su 0, è possibile selezionare al massimo 2000 elementi. I valori superiori a 2000 verranno forzati a 2000. I valori negativi causeranno un errore INVALID_ARGUMENT.
|
Metodi |
|
|
Genera una nuova sessione durante la quale l'utente può scegliere foto e video per l'accesso di terze parti. |
|
|
Consente di eliminare la sessione specificata. |
|
|
Recupera le informazioni sulla sessione specificata. |
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 2025-07-25 UTC."],[[["\u003cp\u003eGoogle Photos Picker API provides sessions for users to select photos and videos.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003ePickingSession\u003c/code\u003e resource represents the user's selection session, including a URI to redirect users to Google Photos for picking media.\u003c/p\u003e\n"],["\u003cp\u003eApplications can poll the API using the recommended \u003ccode\u003ePollingConfig\u003c/code\u003e to check for session updates and retrieve selected media items.\u003c/p\u003e\n"],["\u003cp\u003eSessions have an expiration time and can be programmatically created, retrieved, and deleted using the API methods.\u003c/p\u003e\n"]]],["A `PickingSession` represents a user's photo/video selection process in Google Photos, identified by a unique ID. It provides a `pickerUri` to direct users to Google Photos for media selection. `PollingConfig` defines API polling parameters with `pollInterval` and `timeoutIn`. A session expires at a specified `expireTime`, after which access ends. Once `mediaItemsSet` is true, selected media can be requested. Methods allow to `create`, `get` and `delete` sessions.\n"],null,["# REST Resource: sessions\n\n- [Resource: PickingSession](#PickingSession)\n - [JSON representation](#PickingSession.SCHEMA_REPRESENTATION)\n- [PollingConfig](#PollingConfig)\n - [JSON representation](#PollingConfig.SCHEMA_REPRESENTATION)\n- [PickingConfig](#PickingConfig)\n - [JSON representation](#PickingConfig.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: PickingSession\n------------------------\n\nRepresentation of a user session during which the user can pick photos and videos using Google Photos.\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"id\": string, \"pickerUri\": string, \"pollingConfig\": { object (/photos/picker/reference/rest/v1/sessions#PollingConfig) }, \"expireTime\": string, \"pickingConfig\": { object (/photos/picker/reference/rest/v1/sessions#PickingConfig) }, \"mediaItemsSet\": boolean } ``` |\n\n| Fields ||\n|-----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `id` | `string` Output only. The Google-generated identifier for this session. |\n| `pickerUri` | `string` Output only. The URI used to redirect the user to Google Photos (on web) so they can pick photos and videos for the current session. To view this page successfully, the user must be logged into the Google account that owns this session in their web browser. The `pickerUri` cannot be opened in an iframe due to security reasons. |\n| `pollingConfig` | `object (`[PollingConfig](/photos/picker/reference/rest/v1/sessions#PollingConfig)`)` Output only. The recommended configuration that applications should use while polling `sessions.get`. This field is only populated if media items have not yet been picked for this session (i.e., `mediaItemsSet` is false). |\n| `expireTime` | `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` Output only. Time when access to this session (and its picked media items) will expire. Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than \"Z\" are also accepted. Examples: `\"2014-10-02T15:01:23Z\"`, `\"2014-10-02T15:01:23.045123456Z\"` or `\"2014-10-02T15:01:23+05:30\"`. |\n| `pickingConfig` | `object (`[PickingConfig](/photos/picker/reference/rest/v1/sessions#PickingConfig)`)` Optional. Photo-picking configuration for the user's picking experience during this session. This is specified by the client application when calling `sessions.create`, and cannot be modified after the fact (without creating a new session). |\n| `mediaItemsSet` | `boolean` Output only. If set to `true`, media items have been picked for this session and your application can request the list of picked media items via `mediaItems.list`. |\n\nPollingConfig\n-------------\n\nConfiguration for polling the API.\n\n| JSON representation |\n|---------------------------------------------------------|\n| ``` { \"pollInterval\": string, \"timeoutIn\": string } ``` |\n\n| Fields ||\n|----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pollInterval` | `string (`[Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration)` format)` Output only. Recommended time between poll requests. A duration in seconds with up to nine fractional digits, ending with '`s`'. Example: `\"3.5s\"`. |\n| `timeoutIn` | `string (`[Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration)` format)` Output only. The length of time after which the client should stop polling. A value of 0 indicates that the client should stop polling if it hasn't already. A duration in seconds with up to nine fractional digits, ending with '`s`'. Example: `\"3.5s\"`. |\n\nPickingConfig\n-------------\n\nClient-specified configuration for the user's picking experience during this session.\n\n| JSON representation |\n|------------------------------------|\n| ``` { \"maxItemCount\": string } ``` |\n\n| Fields ||\n|----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `maxItemCount` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Optional. The maximum number of items that the user can pick during this session. Defaults to 2000 if not specified. If unspecified or set to 0, at most 2000 items can be picked. Values above 2000 will be coerced to 2000. Negative values will result in an `INVALID_ARGUMENT` error. |\n\n| Methods ------- ||\n|----------------------------------------------------------------|--------------------------------------------------------------------------------------------------|\n| ### [create](/photos/picker/reference/rest/v1/sessions/create) | Generates a new session during which the user can pick photos and videos for third-party access. |\n| ### [delete](/photos/picker/reference/rest/v1/sessions/delete) | Deletes the specified session. |\n| ### [get](/photos/picker/reference/rest/v1/sessions/get) | Retrieves information about the specified session. |"]]
