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 ऐप्लिकेशन की सेटिंग में उपयोगकर्ताओं को दिखेगी. हालांकि, इसमें सिर्फ़ इस एपीआई की मदद से बदलाव किया जा सकता है.

मान्य डिसप्ले नेम में 1 से 100 वर्ण होने चाहिए.
mediaSources[]

object (AmbientMediaSource)

सिर्फ़ आउटपुट के लिए. इस डिवाइस के लिए सेट किए गए मीडिया सोर्स.

मीडिया सोर्स, ऐसे एल्बम या फ़ोटो कलेक्शन होते हैं जिन्हें उपयोगकर्ता किसी डिवाइस पर दिखाने के लिए चुनता है.

ध्यान दें कि अगर उपयोगकर्ता ने इस डिवाइस के लिए कोई मीडिया सोर्स नहीं चुना है, तो यह फ़ील्ड खाली रहेगा (यानी mediaSourcesSet = false).
settingsUri

string

सिर्फ़ आउटपुट के लिए. यह यूआरआई, उपयोगकर्ता को Google Photos ऐप्लिकेशन में डिवाइस की सेटिंग पर रीडायरेक्ट करने के लिए इस्तेमाल किया जाता है.
createTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. इस डिवाइस को बनाने का समय.

आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़्ड होगा और इसमें 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

एपीआई को पोल करने के लिए कॉन्फ़िगरेशन.

JSON के काेड में दिखाना 
{
  "pollInterval": string
}
फ़ील्ड
pollInterval

string (Duration format)

सिर्फ़ आउटपुट के लिए. पोल के अनुरोधों के बीच का सुझाया गया समय.

सेकंड में कुल अवधि, जिसमें दशमलव के बाद नौ अंक हो सकते हैं. यह अवधि 's' पर खत्म होती है. उदाहरण: "3.5s".

तरीके

create

 उपयोगकर्ता के Google Photos खाते में ऐंबियंट डिवाइस बनाता है.

delete

 यह सुविधा, उपयोगकर्ता के Google Photos खाते से चुने गए डिवाइस को हटा देती है.

get

 किसी डिवाइस के बारे में जानकारी दिखाता है.

patch

 चुने गए डिवाइस की जानकारी अपडेट करता है.