REST Resource: devices

Risorsa: AmbientDevice

Rappresentazione di un dispositivo Ambient.

Rappresentazione JSON
{
  "id": string,
  "displayName": string,
  "mediaSources": [
    {
      object (AmbientMediaSource)
    }
  ],
  "settingsUri": string,
  "createTime": string,
  "pollingConfig": {
    object (PollingConfig)
  },
  "mediaSourcesSet": boolean
}
Campi
id

string

Solo output. L'identificatore univoco di questo dispositivo.

displayName

string

Obbligatorio. Un nome visualizzato definito dall'utente per questo dispositivo.

Sarà visibile agli utenti dalle impostazioni dell'app Google Foto, ma potrà essere modificato solo tramite questa API.

I nomi visualizzati validi devono avere una lunghezza compresa tra 1 e 100 caratteri (inclusi).

mediaSources[]

object (AmbientMediaSource)

Solo output. Le sorgenti multimediali impostate per questo dispositivo.

Le origini multimediali sono album o raccolte di foto che l'utente seleziona per la visualizzazione su un dispositivo.

Tieni presente che questo valore sarà vuoto se l'utente non ha selezionato sorgenti multimediali per questo dispositivo (ovvero mediaSourcesSet = false).

settingsUri

string

Solo output. L'URI utilizzato per reindirizzare l'utente alle impostazioni del dispositivo all'interno dell'app Google Foto.

createTime

string (Timestamp format)

Solo output. L'ora in cui è stato creato il dispositivo.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

pollingConfig

object (PollingConfig)

Solo output. La configurazione consigliata che le applicazioni devono utilizzare durante l'esecuzione di polling devices.get.

mediaSourcesSet

boolean

Solo output. Se impostato, le origini multimediali sono state configurate per questo dispositivo e i client dovrebbero essere in grado di richiedere un elenco di elementi multimediali per questo dispositivo.

AmbientMediaSource

Rappresenta una sorgente multimediale selezionata da un utente per un dispositivo Ambient.

Rappresentazione JSON
{
  "id": string,
  "displayName": string
}
Campi
id

string

Solo output. Identificatore della sorgente multimediale in modalità Ambient.

displayName

string

Solo output. Nome visualizzato per questa origine di contenuti multimediali.

PollingConfig

Configurazione per l'esecuzione di polling dell'API.

Rappresentazione JSON
{
  "pollInterval": string
}
Campi
pollInterval

string (Duration format)

Solo output. Tempo consigliato tra le richieste di sondaggio.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".

Metodi

create

Crea un dispositivo Ambient nell'account Google Foto dell'utente.

delete

Rimuove il dispositivo specificato dall'account Google Foto dell'utente.

get

Recupera le informazioni sul dispositivo specificato.

patch

Aggiorna le informazioni sul dispositivo specificato.