Method: devices.list

列出连接到已验证用户账号的 Ambient 设备。仅返回由发起调用的应用创建的设备。

HTTP 请求

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

网址采用 gRPC 转码语法。

查询参数

参数
pageSize

integer

可选。要返回的设备数量上限。

服务返回的值可能少于此值（包括零个结果）。如果未指定或设置为 0，则最多返回 50 个设备。最大值为 100；高于 100 的值将被强制转换为 100。负值将导致 INVALID_ARGUMENT 错误。
pageToken

string

可选。从之前的 devices.list 调用接收的页面令牌。利用其进行后续页面检索。

请求正文

请求正文必须为空。

响应正文

对 devices.list RPC 的响应。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "devices": [
    {
      object (AmbientDevice)
    }
  ],
  "nextPageToken": string
}
字段
devices[]

object (AmbientDevice)

已连接到用户 Google 相册账号的氛围模式设备页面。
nextPageToken

string

一个令牌，可作为 pageToken 发送，以检索 devices.list 请求中的下一页。

如果省略此字段，则不存在后续页面。

授权范围

需要以下 OAuth 范围：

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