Method: devices.patch

Cập nhật thông tin về thiết bị đã chỉ định.

Lỗi NOT_FOUND sẽ được trả về nếu thiết bị không tồn tại hoặc không thuộc quyền sở hữu của người dùng.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
deviceId

string

Bắt buộc. Giá trị nhận dạng duy nhất của thiết bị này.

Tham số truy vấn

Thông số
updateMask

string (FieldMask format)

Không bắt buộc. Danh sách các trường AmbientDevice cần cập nhật.

Ví dụ: để cập nhật displayName của thiết bị, bạn phải cung cấp đường dẫn trường userSettings.displayName trong updateMask của yêu cầu.

Bạn có thể dùng giá trị đặc biệt * để cho biết rằng tất cả các trường (có thể cập nhật) đều phải được cập nhật.

Nếu bạn bỏ qua, một mặt nạ trường ngầm ẩn tương đương với tất cả các trường được điền sẵn trong device (tức là có giá trị không trống) sẽ được sử dụng.

Đây là danh sách các tên trường đủ điều kiện được phân tách bằng dấu phẩy. Ví dụ: "user.displayName,photo"

Nội dung yêu cầu

Nội dung yêu cầu chứa một bản sao của AmbientDevice.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của AmbientDevice.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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