REST Resource: devices

Recurso: AmbientDevice

Representación de un dispositivo ambiente.

Representación JSON
{
  "id": string,
  "displayName": string,
  "mediaSources": [
    {
      object (AmbientMediaSource)
    }
  ],
  "settingsUri": string,
  "createTime": string,
  "pollingConfig": {
    object (PollingConfig)
  },
  "mediaSourcesSet": boolean
}
Campos
id

string

Solo salida. Es el identificador único de este dispositivo.

displayName

string

Obligatorio. Es un nombre visible definido por el usuario para este dispositivo.

Los usuarios podrán verlo en la configuración de la app de Google Fotos, pero solo podrán editarlo a través de esta API.

Los nombres visibles válidos deben tener entre 1 y 100 caracteres (inclusive).

mediaSources[]

object (AmbientMediaSource)

Solo salida. Las fuentes de contenido multimedia configuradas para este dispositivo

Las fuentes de contenido multimedia son álbumes o colecciones de fotos que el usuario selecciona para mostrar en un dispositivo.

Ten en cuenta que estará vacío si el usuario no seleccionó ninguna fuente de contenido multimedia para este dispositivo (es decir, mediaSourcesSet = false).

settingsUri

string

Solo salida. Es el URI que se usa para redireccionar al usuario a la configuración del dispositivo en la app de Google Fotos.

createTime

string (Timestamp format)

Solo salida. La hora en la que se creó este dispositivo.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

pollingConfig

object (PollingConfig)

Solo salida. Es la configuración recomendada que deben usar las aplicaciones mientras sondean devices.get.

mediaSourcesSet

boolean

Solo salida. Si se configuran, las fuentes de contenido multimedia se configuran para este dispositivo y los clientes deberían poder solicitar una lista de elementos multimedia para este dispositivo.

AmbientMediaSource

Representa una fuente de contenido multimedia que un usuario seleccionó para un dispositivo ambiente.

Representación JSON
{
  "id": string,
  "displayName": string
}
Campos
id

string

Solo salida. Es el identificador de la fuente de contenido multimedia ambiente.

displayName

string

Solo salida. Es el nombre visible de esta fuente de contenido multimedia.

PollingConfig

Configuración para sondear la API.

Representación JSON
{
  "pollInterval": string
}
Campos
pollInterval

string (Duration format)

Solo salida. Es el tiempo recomendado entre las solicitudes de sondeo.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

Métodos

create

Crea un dispositivo ambiente en la cuenta de Google Fotos del usuario.

delete

Quita el dispositivo especificado de la cuenta de Google Fotos del usuario.

get

Recupera información sobre el dispositivo especificado.

patch

Actualiza la información sobre el dispositivo especificado.