REST Resource: devices

Recurso: AmbientDevice

Representação de um dispositivo ambiente.

Representação JSON
{
  "id": string,
  "displayName": string,
  "mediaSources": [
    {
      object (AmbientMediaSource)
    }
  ],
  "settingsUri": string,
  "createTime": string,
  "pollingConfig": {
    object (PollingConfig)
  },
  "mediaSourcesSet": boolean
}
Campos
id

string

Apenas saída. O identificador exclusivo desse dispositivo.

displayName

string

Obrigatório. Um nome de exibição definido pelo usuário para esse dispositivo.

Essa informação vai ficar visível para os usuários nas configurações do app Google Fotos, mas só poderá ser editada por essa API.

Os nomes de exibição válidos precisam ter entre 1 e 100 caracteres.

mediaSources[]

object (AmbientMediaSource)

Apenas saída. As fontes de mídia definidas para o dispositivo.

As fontes de mídia são álbuns ou coleções de fotos que o usuário seleciona para exibir em um dispositivo.

Esse campo vai estar vazio se o usuário não tiver selecionado nenhuma fonte de mídia para o dispositivo (ou seja, mediaSourcesSet = false).

settingsUri

string

Apenas saída. O URI usado para redirecionar o usuário às configurações do dispositivo no app Google Fotos.

createTime

string (Timestamp format)

Apenas saída. A hora em que o dispositivo foi criado.

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa dígitos fracionários 0, 3, 6 ou 9. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

pollingConfig

object (PollingConfig)

Apenas saída. A configuração recomendada que os aplicativos precisam usar ao consultar devices.get.

mediaSourcesSet

boolean

Apenas saída. Se definido, as fontes de mídia foram configuradas para esse dispositivo, e os clientes poderão solicitar uma lista de itens de mídia para ele.

AmbientMediaSource

Representa uma fonte de mídia selecionada por um usuário para um dispositivo de ambiente.

Representação JSON
{
  "id": string,
  "displayName": string
}
Campos
id

string

Apenas saída. Identificador da fonte de mídia ambiente.

displayName

string

Apenas saída. Nome de exibição dessa fonte de mídia.

PollingConfig

Configuração para consultar a API.

Representação JSON
{
  "pollInterval": string
}
Campos
pollInterval

string (Duration format)

Apenas saída. Tempo recomendado entre as solicitações de pesquisa.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

Métodos

create

Cria um dispositivo ambiente na conta do Google Fotos do usuário.

delete

Remove o dispositivo especificado da conta do Google Fotos do usuário.

get

Recupera informações sobre o dispositivo especificado.

patch

Atualiza as informações sobre o dispositivo especificado.