Method: devices.create

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

अगर दिए गए requestId वाला डिवाइस पहले से मौजूद है, तो ALREADY_EXISTS गड़बड़ी का मैसेज दिखता है. डुप्लीकेट डिवाइसों को रोकने के लिए, यह तरीका अपनाएं:

  • अगर आपको मौजूदा डिवाइस का deviceId पता है, तो उसे वापस पाने के लिए devices.get को कॉल करें.
  • अगर आपको deviceId नहीं पता है, तो इस तरीके को फिर से आज़माने से पहले, requestId के साथ devices.delete को कॉल करके, ऑरफ़न डिवाइस को हटाएं.

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

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

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

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

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

पैरामीटर
requestId

string

ज़रूरी नहीं. इस अनुरोध के लिए, क्लाइंट से मिला यूनीक आइडेंटिफ़ायर. इसका इस्तेमाल, नेटवर्क के काम न करने पर, संसाधनों के डुप्लीकेट होने की समस्या को कम करने के लिए किया जाता है.

यह आईडी, UUID (वर्शन 4) स्ट्रिंग के फ़ॉर्मैट में होना चाहिए. साथ ही, यह इन ज़रूरी शर्तों के मुताबिक होना चाहिए:

  • इसमें उपयोगकर्ता की पहचान से जुड़ी कोई संवेदनशील जानकारी शामिल नहीं होनी चाहिए.
  • इसमें 32 हेक्साडेसिमल वर्ण होने चाहिए. इन्हें पांच ग्रुप में बांटा गया है और इनके बीच में हाइफ़न लगा है. यह "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" (या 8-4-4-4-12) फ़ॉर्मैट में होना चाहिए.

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

अनुरोध के मुख्य भाग में AmbientDevice का उदाहरण है.

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

कामयाब रहने पर, जवाब के मुख्य हिस्से में AmbientDevice का नया इंस्टेंस शामिल किया जाता है.

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

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

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