Method: devices.list

แสดงรายการอุปกรณ์แวดล้อมที่เชื่อมต่อกับบัญชีของผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์แล้ว แสดงผลเฉพาะอุปกรณ์ที่สร้างโดยแอปพลิเคชันการโทร

คำขอ HTTP

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

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

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

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

integer

ไม่บังคับ จำนวนอุปกรณ์สูงสุดที่จะส่งคืน

บริการอาจแสดงผลน้อยกว่าค่านี้ (รวมถึงผลลัพธ์เป็น 0) หากไม่ระบุหรือตั้งค่าเป็น 0 ระบบจะส่งคืนอุปกรณ์ไม่เกิน 50 เครื่อง ค่าสูงสุดคือ 100 ค่าที่มากกว่า 100 จะถูกเปลี่ยนเป็น 100 ค่าติดลบจะทำให้เกิดข้อผิดพลาด INVALID_ARGUMENT

pageToken

string

ไม่บังคับ โทเค็นของหน้าเว็บที่ได้รับจากการโทร devices.list ก่อนหน้า ระบุพารามิเตอร์นี้เพื่อเรียกข้อมูลหน้าถัดไป

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

เนื้อหาของคำขอต้องว่างเปล่า

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

การตอบกลับ RPC ของ devices.list

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON
{
  "devices": [
    {
      object (AmbientDevice)
    }
  ],
  "nextPageToken": string
}
ช่อง
devices[]

object (AmbientDevice)

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

nextPageToken

string

โทเค็นที่ส่งในฐานะ pageToken เพื่อเรียกข้อมูลหน้าถัดไปในคำขอ devices.list ได้

หากเว้นช่องนี้ไว้ จะไม่มีหน้าลำดับต่อมา

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

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

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