Method: mediaItems.list

Muestra una lista de elementos multimedia seleccionados por el usuario durante la sesión especificada.

Se mostrará un error FAILED_PRECONDITION si la sesión aún no tiene ningún elemento multimedia seleccionado y, por lo tanto, no puede mostrar contenido multimedia. En esta situación, las aplicaciones que se ejecutan en dispositivos de entrada limitada deben renderizar un código QR que codifique el pickerUri de la sesión para indicarle al usuario que escanee el código y seleccione elementos multimedia en la IU del selector de Google Fotos. Mientras esperan a que el usuario elija sus artículos, los clientes deben sondear sessions.get, una vez cada pollingConfig.pollInterval, hasta pickedItemsSet = true en la respuesta de sessions.get. En ese momento, los clientes pueden reanudar la llamada a mediaItems.list y esperar recibir una respuesta exitosa.

Solicitud HTTP

GET https://photospicker.googleapis.com/v1/mediaItems

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de consulta

Parámetros
sessionId

string

Obligatorio. Es el identificador generado por Google para esta sesión.

pageSize

integer

Opcional. La cantidad máxima de elementos multimedia que se mostrarán.

Es posible que el servicio muestre menos que este valor (incluidos cero resultados). Si no se especifica o se establece en 0, se mostrarán 50 elementos multimedia como máximo. El valor máximo es 100. los valores superiores a 100 se convertirán en 100. Los valores negativos generarán un error INVALID_ARGUMENT.

pageToken

string

Opcional. Un token de página, recibido desde una llamada mediaItems.list anterior. Proporciona esto para recuperar la página siguiente.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Una respuesta a la RPC mediaItems.list.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON
{
  "mediaItems": [
    {
      object (PickedMediaItem)
    }
  ],
  "nextPageToken": string
}
Campos
mediaItems[]

object (PickedMediaItem)

Una página de elementos multimedia seleccionados.

nextPageToken

string

Un token, que se puede enviar como pageToken para recuperar la página siguiente en una solicitud mediaItems.list.

Alcances de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/photospicker.mediaitems.readonly