Method: devices.create

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

如果已存在具有所提供 requestId 的设备，则会返回 ALREADY_EXISTS 错误。为帮助防止重复设备，请执行以下操作：

  • 如果您知道现有设备的 deviceId，请调用 devices.get 来检索它。
  • 如果您不知道 deviceId，请使用 requestId 调用 devices.delete 以移除孤岛设备，然后重试此方法。

您最多可以为应用的每位用户创建 100 部设备。如果超出此限制，系统会返回 RESOURCE_EXHAUSTED 错误。

HTTP 请求

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

网址采用 gRPC 转码语法。

查询参数

参数
requestId

string

可选。客户端为此请求提供的唯一标识符。这用于在网络故障时减少资源重复。

此 ID 必须采用 UUID（版本 4）字符串格式，并符合以下要求：

  • 不得包含任何与用户相关的敏感身份信息。
  • 必须包含 32 个十六进制字符，分为五组，以连字符分隔，格式为“xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”（或 8-4-4-4-12）。

请求正文

请求正文包含一个 AmbientDevice 实例。

响应正文

如果成功，响应正文将包含一个新创建的 AmbientDevice 实例。

授权范围

需要以下 OAuth 范围：

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