REST Resource: devices

ทรัพยากร: AmbientDevice

การนําเสนออุปกรณ์แอมเบียนท์

การแสดง JSON 
{
  "id": string,
  "displayName": string,
  "mediaSources": [
    {
      object (AmbientMediaSource)
    }
  ],
  "settingsUri": string,
  "createTime": string,
  "pollingConfig": {
    object (PollingConfig)
  },
  "mediaSourcesSet": boolean
}
ช่อง
id

string

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

string

ต้องระบุ ชื่อที่แสดงที่ผู้ใช้กำหนดสำหรับอุปกรณ์นี้

ผู้ใช้จะเห็นการตั้งค่านี้จากการตั้งค่าแอป Google Photos แต่แก้ไขได้ผ่าน API นี้เท่านั้น

ชื่อที่แสดงที่ถูกต้องต้องมีความยาวระหว่าง 1 ถึง 100 อักขระ (รวม)
mediaSources[]

object (AmbientMediaSource)

เอาต์พุตเท่านั้น แหล่งที่มาของสื่อที่ตั้งค่าไว้สำหรับอุปกรณ์นี้

แหล่งที่มาของสื่อคืออัลบั้มหรือคอลเล็กชันรูปภาพที่ผู้ใช้เลือกให้แสดงในอุปกรณ์

โปรดทราบว่าช่องนี้จะว่างเปล่าหากผู้ใช้ไม่ได้เลือกแหล่งที่มาของสื่อสำหรับอุปกรณ์นี้ (นั่นคือ mediaSourcesSet = เท็จ)
settingsUri

string

เอาต์พุตเท่านั้น URI ที่ใช้เปลี่ยนเส้นทางผู้ใช้ไปยังการตั้งค่าของอุปกรณ์ภายในแอป Google Photos
createTime

string (Timestamp format)

เอาต์พุตเท่านั้น เวลาที่สร้างอุปกรณ์นี้

ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 0, 3, 6 หรือ 9 ระบบยังยอมรับออฟเซตอื่นๆ นอกเหนือจาก "Z" ด้วย ตัวอย่างเช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
pollingConfig

object (PollingConfig)

เอาต์พุตเท่านั้น การกําหนดค่าที่แนะนําซึ่งแอปพลิเคชันควรใช้ขณะที่ทำการโพล devices.get
mediaSourcesSet

boolean

เอาต์พุตเท่านั้น หากตั้งค่าไว้ ระบบจะกําหนดค่าแหล่งข้อมูลสื่อสําหรับอุปกรณ์นี้ไว้แล้ว และไคลเอ็นต์ควรขอรายการรายการสื่อสําหรับอุปกรณ์นี้ได้

AmbientMediaSource

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

การแสดง JSON 
{
  "id": string,
  "displayName": string
}
ช่อง
id

string

เอาต์พุตเท่านั้น ตัวระบุแหล่งที่มาของสื่อรอบตัว
displayName

string

เอาต์พุตเท่านั้น ชื่อที่แสดงสําหรับแหล่งที่มาของสื่อนี้

PollingConfig

การกําหนดค่าสําหรับการโหวต API

การแสดง JSON 
{
  "pollInterval": string
}
ช่อง
pollInterval

string (Duration format)

เอาต์พุตเท่านั้น ระยะเวลาที่แนะนำระหว่างคำขอแบบสำรวจ

ระยะเวลาเป็นวินาทีที่มีเศษทศนิยมได้สูงสุด 9 หลัก โดยลงท้ายด้วย "s" เช่น "3.5s"

เมธอด

create

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

delete

 นำอุปกรณ์ที่ระบุออกจากบัญชี Google Photos ของผู้ใช้

get

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

patch

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