Method: devices.patch

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

如果设备不存在或不归该用户所有,系统会返回 NOT_FOUND 错误。

HTTP 请求

PATCH https://photosambient.googleapis.com/v1/devices/{deviceId}

网址采用 gRPC 转码语法。

路径参数

参数
deviceId

string

必需。此设备的唯一标识符。

查询参数

参数
updateMask

string (FieldMask format)

可选。要更新的 AmbientDevice 字段的列表。

例如,如需更新设备的 displayName,必须在请求的 updateMask 中提供字段路径 userSettings.displayName

特殊值 * 可用于指示应更新所有(可更新的)字段。

如果省略,系统将改用等同于 device 中填充的所有字段(即具有非空值)的隐式字段掩码。

这是完全限定字段名称的逗号分隔列表。示例:"user.displayName,photo"

请求正文

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

响应正文

如果成功,则响应正文包含一个 AmbientDevice 实例。

授权范围

需要以下 OAuth 范围:

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