REST Resource: sessions

Recurso: PickingSession

Representación de una sesión del usuario durante la cual 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 a la Cuenta de Google propietaria de esta sesión en su navegador web.

El pickerUri no se puede abrir en un iframe por motivos de seguridad.

pollingConfig

object (PollingConfig)

Solo salida. Es la configuración recomendada que deben usar las aplicaciones 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. Hora a la que vencerá el acceso a esta sesión (y a sus elementos multimedia seleccionados).

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "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. 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 establece en 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

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 cantidad de tiempo después de la cual el cliente debe dejar de sondear.

Un valor de 0 indica que el cliente debe dejar de sondear 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. Si no se especifica, el valor predeterminado es 2000.

Si no se especifica o se establece en 0, se pueden elegir como máximo 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.