Method: devices.list

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

एचटीटीपी अनुरोध

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

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

क्वेरी पैरामीटर

पैरामीटर
pageSize

integer

ज़रूरी नहीं. लौटाने के लिए डिवाइसों की ज़्यादा से ज़्यादा संख्या.

सेवा इस वैल्यू से कम वैल्यू दिखा सकती है (इसमें शून्य नतीजे भी शामिल हैं). अगर इसकी जानकारी नहीं दी जाती या 0 पर सेट किया जाता है, तो ज़्यादा से ज़्यादा 50 डिवाइस लौटाए जाएंगे. ज़्यादा से ज़्यादा वैल्यू 100 है; अगर वैल्यू 100 से ज़्यादा है, तो उसे 100 बना दिया जाएगा. नेगेटिव वैल्यू की वजह से INVALID_ARGUMENT गड़बड़ी होगी.
pageToken

string

ज़रूरी नहीं. पिछले devices.list कॉल से मिला पेज टोकन. अगले पेज को वापस पाने के लिए, यह जानकारी दें.

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य भाग

devices.list RPC का जवाब.

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

JSON के काेड में दिखाना 
{
  "devices": [
    {
      object (AmbientDevice)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
devices[]

object (AmbientDevice)

ऐंबियंट डिवाइसों का एक पेज, जो उपयोगकर्ता के Google Photos खाते से जुड़ा है.
nextPageToken

string

टोकन, जिसे pageToken के तौर पर भेजा जा सकता है, ताकि devices.list के अनुरोध में अगले पेज को वापस लाया जा सके.

अगर इस फ़ील्ड को हटा दिया जाता है, तो इसके बाद कोई पेज नहीं होता.

अनुमति के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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