REST Resource: sessions

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 correttamente 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.

Per le applicazioni basate sul web, puoi aggiungere /autoclose a questo URI. La finestra o la scheda di Google Foto si chiuderà automaticamente dopo che l'utente avrà terminato la selezione, anziché visualizzare una schermata "Fine".

pollingConfig

object (PollingConfig)

Solo output. La configurazione consigliata che le applicazioni devono utilizzare durante il polling di sessions.get.

Questo campo viene compilato solo se gli elementi multimediali non sono ancora stati scelti per questa sessione (ovvero mediaItemsSet è falso).

expireTime

string (Timestamp format)

Solo output. L'ora in cui scadrà l'accesso a questa sessione (e ai relativi contenuti multimediali selezionati).

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. 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 selezione delle foto per l'esperienza di selezione dell'utente durante questa sessione.

Questo valore viene specificato dall'applicazione client quando chiama sessions.create e non può essere modificato in un secondo momento (senza creare una nuova sessione).

mediaItemsSet

boolean

Solo output. Se impostato su true, gli elementi multimediali sono stati selezionati per questa sessione e la tua applicazione può richiedere l'elenco degli elementi multimediali selezionati tramite mediaItems.list.

PollingConfig

Configurazione per il 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 il polling.

Un valore pari a 0 indica che il client deve interrompere il 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 prelievo 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 genereranno un errore INVALID_ARGUMENT.

Metodi

create

Genera una nuova sessione durante la quale l'utente può scegliere foto e video per l'accesso di terze parti.

delete

Elimina la sessione specificata.

get

Recupera le informazioni sulla sessione specificata.