Method: mediaItems.patch

मीडिया आइटम को बताए गए id के साथ अपडेट करें. मीडिया आइटम के सिर्फ़ id और description फ़ील्ड को पढ़ा जाता है. मीडिया आइटम को डेवलपर ने एपीआई के ज़रिए बनाया हो और उसका मालिकाना हक उपयोगकर्ता के पास हो.

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

PATCH https://photoslibrary.googleapis.com/v1/mediaItems/{mediaItem.id}

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

पाथ पैरामीटर

पैरामीटर
mediaItem.id

string

मीडिया आइटम का आइडेंटिफ़ायर. यह एक पर्सिस्टेंट आइडेंटिफ़ायर है. इसका इस्तेमाल, सेशन के बीच इस मीडिया आइटम की पहचान करने के लिए किया जा सकता है.

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

पैरामीटर
updateMask

string (FieldMask format)

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

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

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

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

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

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

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

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

  • https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata