Method: devices.patch

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

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

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

PATCH https://photosambient.googleapis.com/v1/devices/{deviceId}

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

पाथ पैरामीटर

पैरामीटर
deviceId

string

ज़रूरी है. इस डिवाइस का यूनीक आइडेंटिफ़ायर.

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

पैरामीटर
updateMask

string (FieldMask format)

ज़रूरी नहीं. अपडेट किए जाने वाले AmbientDevice फ़ील्ड की सूची.

उदाहरण के लिए, डिवाइस के displayName को अपडेट करने के लिए, अनुरोध के updateMask में फ़ील्ड पाथ userSettings.displayName दिया जाना चाहिए.

खास वैल्यू * का इस्तेमाल करके यह दिखाया जा सकता है कि अपडेट किए जा सकने वाले सभी फ़ील्ड को अपडेट किया जाना चाहिए.

अगर इसे हटाया जाता है, तो इसके बजाय device में अपने-आप भरे गए सभी फ़ील्ड (यानी कि ऐसी वैल्यू होती है जो खाली नहीं है) के बराबर की अनुमानित फ़ील्ड मास्क का इस्तेमाल किया जाएगा.

यह फ़ील्ड के पूरी तरह से क्वालिफ़ाइड नामों की सूची है. इसमें नामों को कॉमा लगाकर अलग किया गया है. उदाहरण: "user.displayName,photo".

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

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

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

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

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

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

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