REST Resource: devices

资源：AmbientDevice

氛围设备的表示。

JSON 表示法 
{
  "id": string,
  "displayName": string,
  "mediaSources": [
    {
      object (AmbientMediaSource)
    }
  ],
  "settingsUri": string,
  "createTime": string,
  "pollingConfig": {
    object (PollingConfig)
  },
  "mediaSourcesSet": boolean
}
字段
id

string

仅限输出。此设备的唯一标识符。
displayName

string

必需。此设备的用户定义显示名称。

用户可以在 Google 相册应用设置中看到此信息，但只能通过此 API 进行修改。

有效的显示名称必须介于 1 到 100 个字符（包括这两个数值）之间。
mediaSources[]

object (AmbientMediaSource)

仅限输出。为此设备设置的媒体来源。

媒体来源是用户选择在设备上显示的影集或照片合集。

请注意，如果用户未为此设备选择任何媒体来源（即 mediaSourcesSet = false），则此字段将为空。
settingsUri

string

仅限输出。用于将用户重定向到 Google 相册应用中的设备设置的 URI。
createTime

string (Timestamp format)

仅限输出。此设备的创建时间。

采用 RFC 3339 标准，生成的输出将始终在末尾带 Z，并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
pollingConfig

object (PollingConfig)

仅限输出。应用在轮询 devices.get 时应使用的建议配置。
mediaSourcesSet

boolean

仅限输出。如果已设置，则表示已为此设备配置媒体来源，并且客户端应能够请求此设备的媒体内容列表。

AmbientMediaSource

表示用户为氛围模式设备选择的媒体来源。

JSON 表示法 
{
  "id": string,
  "displayName": string
}
字段
id

string

仅限输出。氛围媒体源的标识符。
displayName

string

仅限输出。此媒体来源的显示名称。

PollingConfig

用于轮询 API 的配置。

JSON 表示法 
{
  "pollInterval": string
}
字段
pollInterval

string (Duration format)

仅限输出。建议的轮询请求间隔时间。

该时长以秒为单位，最多包含九个小数位，以“s”结尾。示例："3.5s"。

方法

create

 在用户的 Google 相册账号中创建氛围模式设备。

delete

 从用户的 Google 相册账号中移除指定设备。

get

 检索指定设备的相关信息。

patch

 更新指定设备的相关信息。