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