Method: mediaItems.list

Muestra una lista de elementos de contenido multimedia ambiente de las fuentes de contenido multimedia configuradas por el usuario para el dispositivo especificado.

De forma predeterminada, listMediaItems proporciona la experiencia de Ambient, que muestra un conjunto seleccionado de elementos multimedia de todas las fuentes configuradas por el usuario.

De manera opcional, puedes incluir mediaSourceId en la solicitud para recuperar una lista paginada de elementos de una fuente de contenido multimedia específica, lo que permite un filtrado más tradicional.

Las aplicaciones cliente tienen un límite de 240 solicitudes por dispositivo por día.

Se produce un error FAILED_PRECONDITION si el usuario no configuró ninguna fuente de contenido multimedia.

Solicitud HTTP

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

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

Parámetros de consulta

Parámetros
deviceId

string

Obligatorio. Es el identificador único de este dispositivo.
mediaSourceId

string

Opcional. Para la experiencia ambiente, omite este campo. Se mostrará un conjunto seleccionado de elementos multimedia de todas las fuentes configuradas. La cantidad de elementos que se muestren respetará tu solicitud de pageSize, hasta un máximo de 100 elementos. Si se especifica, solo se mostrarán los elementos de la fuente de contenido multimedia especificada.

El id debe ser de una fuente que el usuario seleccionó para el dispositivo especificado (es decir, uno de AmbientDevice.media_sources.id).

Ten en cuenta que highlights no es compatible, incluso si el usuario selecciona esta fuente para el dispositivo. Si configuras este campo en highlights, se mostrará un error INVALID_ARGUMENT.
pageSize

integer

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

El servicio respetará tu solicitud de pageSize, aunque es posible que devuelva menos elementos de los especificados (incluidos cero resultados).

Si no se especifica pageSize o se establece en 0, se mostrarán como máximo 50 elementos multimedia. Los valores superiores a 100 se reducirán al valor máximo permitido de 100. Si proporcionas un valor negativo, se generará 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

Respuesta al método mediaItems.list.

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

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

object (AmbientMediaItem)

Es una página de elementos multimedia ambiente para que los muestre el dispositivo.
nextPageToken

string

Si se configura, este campo se puede usar como pageToken en una llamada mediaItems.list posterior para recuperar la siguiente página de elementos.

Si se omite este campo, no significa necesariamente que no hay más contenido disponible para recuperar, sino que la página de contenido posterior puede contener elementos multimedia que ya se mostraron en páginas anteriores.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/photosambient.mediaitems