REST Resource: sessions

Recurso: PickingSession

Representación de una sesión del usuario durante la cual este puede elegir fotos y videos con Google Fotos.

Representación JSON 
{
  "id": string,
  "pickerUri": string,
  "pollingConfig": {
    object (PollingConfig)
  },
  "expireTime": string,
  "pickingConfig": {
    object (PickingConfig)
  },
  "mediaItemsSet": boolean
}
Campos
id

string

Solo salida. Es el identificador generado por Google para esta sesión.
pickerUri

string

Solo salida. Es el URI que se usa para redireccionar al usuario a Google Fotos (en la Web) para que pueda elegir fotos y videos para la sesión actual.

Para ver esta página correctamente, el usuario debe acceder en su navegador web a la Cuenta de Google que posee esta sesión.

Por motivos de seguridad, no se puede abrir pickerUri en un iframe.

En el caso de las aplicaciones basadas en la Web, puedes agregar /autoclose a este URI. La ventana o pestaña de Google Fotos se cerrará automáticamente después de que el usuario termine de elegir, en lugar de mostrar una pantalla de "Listo".
pollingConfig

object (PollingConfig)

Solo salida. Es la configuración recomendada que las aplicaciones deben usar mientras sondean sessions.get.

Este campo solo se completa si aún no se seleccionaron elementos multimedia para esta sesión (es decir, mediaItemsSet es falso).
expireTime

string (Timestamp format)

Solo salida. Fecha y hora en que vencerá el acceso a esta sesión (y a los elementos multimedia seleccionados).

Usa el formato RFC 3339, en el que el resultado generado siempre estará normalizada a Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
pickingConfig

object (PickingConfig)

Opcional. Es la configuración de selección de fotos para la experiencia de selección del usuario durante esta sesión.

La aplicación cliente lo especifica cuando llama a sessions.create y no se puede modificar después (sin crear una sesión nueva).
mediaItemsSet

boolean

Solo salida. Si se configura como true, se seleccionaron elementos multimedia para esta sesión y tu aplicación puede solicitar la lista de elementos multimedia seleccionados a través de mediaItems.list.

PollingConfig

Es la configuración para sondear la API.

Representación JSON 
{
  "pollInterval": string,
  "timeoutIn": string
}
Campos
pollInterval

string (Duration format)

Solo salida. Es el tiempo recomendado entre las solicitudes de sondeo.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".
timeoutIn

string (Duration format)

Solo salida. Es la duración después de la cual el cliente debe dejar de sondear.

Un valor de 0 indica que el cliente debe detener el sondeo si aún no lo hizo.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

PickingConfig

Es la configuración especificada por el cliente para la experiencia de selección del usuario durante esta sesión.

Representación JSON 
{
  "maxItemCount": string
}
Campos
maxItemCount

string (int64 format)

Opcional. Es la cantidad máxima de elementos que el usuario puede elegir durante esta sesión. El valor predeterminado es 2,000 si no se especifica.

Si no se especifica o se establece en 0, se pueden seleccionar hasta 2,000 elementos. Los valores superiores a 2,000 se convertirán a 2,000. Los valores negativos generarán un error INVALID_ARGUMENT.

Métodos

create

 Genera una sesión nueva durante la cual el usuario puede elegir fotos y videos para el acceso de terceros.

delete

 Borra la sesión especificada.

get

 Recupera información sobre la sesión especificada.