Method: devices.patch

อัปเดตข้อมูลเกี่ยวกับอุปกรณ์ที่ระบุ

ระบบจะแสดงข้อผิดพลาด NOT_FOUND หากอุปกรณ์ไม่อยู่หรือผู้ใช้ไม่ได้เป็นเจ้าของ

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
deviceId

string

ต้องระบุ ตัวระบุที่ไม่ซ้ำกันสำหรับอุปกรณ์นี้

พารามิเตอร์การค้นหา

พารามิเตอร์
updateMask

string (FieldMask format)

ไม่บังคับ รายการช่อง AmbientDevice ที่จะอัปเดต

เช่น หากต้องการอัปเดต displayName ของอุปกรณ์ คุณต้องระบุเส้นทางฟิลด์ userSettings.displayName ใน updateMask ของคําขอ

คุณอาจใช้ค่าพิเศษ * เพื่อระบุว่าควรอัปเดตช่องทั้งหมด (ที่อัปเดตได้)

หากละเว้น ระบบจะใช้มาสก์ช่องโดยนัยซึ่งเทียบเท่ากับช่องทั้งหมดที่ป้อนข้อมูลไว้ใน device (นั่นคือมีค่าที่ไม่ใช่ค่าว่าง) แทน

ซึ่งเป็นรายการชื่อที่ตรงตามเกณฑ์ทั้งหมดของช่องที่คั่นด้วยคอมมา ตัวอย่าง: "user.displayName,photo"

เนื้อหาของคำขอ

เนื้อความของคำขอมีอินสแตนซ์ของ AmbientDevice

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ AmbientDevice

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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