Method: mediaItems.list

Restituisce un elenco di elementi multimediali Ambient dalle origini multimediali configurate dall'utente per il dispositivo specificato.

Per impostazione predefinita, listMediaItems offre l'esperienza Ambient, restituendo un insieme selezionato di elementi multimediali da tutte le origini configurate dall'utente.

Se vuoi, puoi includere mediaSourceId nella richiesta per recuperare un elenco paginato di elementi da una sorgente multimediale specifica, consentendo un filtraggio più tradizionale.

Le applicazioni client sono limitate a 240 richieste per dispositivo al giorno.

Viene visualizzato un errore FAILED_PRECONDITION se l'utente non ha configurato origini multimediali.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di query

Parametri
deviceId

string

Obbligatorio. L'identificatore univoco di questo dispositivo.
mediaSourceId

string

(Facoltativo) Per l'esperienza Ambient, ometti questo campo. Verrà restituito un insieme selezionato di elementi multimediali da tutte le origini configurate. Il numero di elementi restituiti rispetterà la tua richiesta pageSize, fino a un massimo di 100 elementi. Se specificato, verranno restituiti solo gli elementi dell'origine media specificata.

id deve essere di una sorgente selezionata dall'utente per il dispositivo specificato (ad es. una di AmbientDevice.media_sources.id).

Tieni presente che highlights non è supportato anche se è una sorgente selezionata per questo dispositivo dall'utente. Se imposti questo campo su highlights, verrà restituito un errore INVALID_ARGUMENT.
pageSize

integer

(Facoltativo) Il numero massimo di elementi multimediali da restituire.

Il servizio rispetterà la tua richiesta pageSize, anche se potrebbe restituire meno elementi di quelli specificati (inclusi zero risultati).

Se pageSize non è specificato o è impostato su 0, verranno restituiti al massimo 50 elementi multimediali. I valori superiori a 100 verranno forzati al valore massimo consentito di 100. Se fornisci un valore negativo, verrà visualizzato un errore INVALID_ARGUMENT.
pageToken

string

(Facoltativo) Un token di pagina ricevuto da una chiamata mediaItems.list precedente. Fornisci questo valore per recuperare la pagina successiva.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Risposta al metodo mediaItems.list.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "mediaItems": [
    {
      object (AmbientMediaItem)
    }
  ],
  "nextPageToken": string
}
Campi
mediaItems[]

object (AmbientMediaItem)

Una pagina di elementi multimediali ambient da mostrare sul dispositivo.
nextPageToken

string

Se impostato, questo campo può essere utilizzato come pageToken in una chiamata mediaItems.list successiva per recuperare la pagina successiva di elementi.

Se questo campo viene omesso, non significa necessariamente che non sono disponibili altri contenuti da recuperare, ma piuttosto che la pagina di contenuti successiva potrebbe contenere elementi multimediali già restituiti nelle pagine precedenti.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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