Method: devices.create

สร้างอุปกรณ์แอมเบียนท์ในบัญชี Google Photos ของผู้ใช้

หากมีอุปกรณ์ที่มี requestId ที่ระบุอยู่แล้ว ระบบจะแสดงข้อผิดพลาด ALREADY_EXISTS โปรดทำตามขั้นตอนต่อไปนี้เพื่อช่วยป้องกันไม่ให้อุปกรณ์ซ้ำกัน

  • หากทราบ deviceId ของอุปกรณ์ที่มีอยู่ ให้โทรหา devices.get เพื่อเรียกข้อมูล
  • หากไม่ทราบ deviceId ให้โทรหา devices.delete พร้อมแจ้ง requestId เพื่อนำอุปกรณ์ที่แยกออกมาแล้วออกก่อนลองใช้วิธีนี้อีกครั้ง

คุณสร้างอุปกรณ์ได้สูงสุด 100 เครื่องต่อผู้ใช้ 1 คน หากเกินขีดจำกัด ระบบจะแสดงข้อผิดพลาด RESOURCE_EXHAUSTED

คำขอ HTTP

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

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

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

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

string

ไม่บังคับ ตัวระบุที่ไม่ซ้ำกันซึ่งไคลเอ็นต์ระบุสำหรับคำขอนี้ ซึ่งใช้เพื่อลดการซ้ำซ้อนของทรัพยากรในกรณีที่เครือข่ายขัดข้อง

รหัสนี้ต้องอยู่ในรูปแบบสตริง UUID (เวอร์ชัน 4) และเป็นไปตามข้อกําหนดต่อไปนี้

  • ต้องไม่มีข้อมูลที่ละเอียดอ่อนซึ่งระบุตัวตนของผู้ใช้
  • ประกอบด้วยอักขระฐาน 16 32 ตัวที่แบ่งออกเป็น 5 กลุ่มและคั่นด้วยเครื่องหมายขีดกลางในรูปแบบ "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" (หรือ 8-4-4-4-12)

เนื้อความของคำขอ

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

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

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

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

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

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