मीडिया आइटम को अपलोड करने के बाद, उन्हें accessing करने के अलावा, उनके ब्यौरे में भी बदलाव किया जा सकता है.
अनुमति देने का ज़रूरी दायरा
मीडिया आइटम बन जाने के बाद उनके ब्यौरे बदलने के लिए, photoslibrary.edit.appcreateddata
स्कोप का इस्तेमाल करें.
मीडिया आइटम के ब्यौरे में बदलाव करना
मीडिया आइटम की जानकारी बदलने के लिए, मीडिया आइटम के आइडेंटिफ़ायर के साथ media items update call
बनाएं और अनुरोध में नई जानकारी शामिल करें.
मीडिया आइटम की जानकारी बदलने के लिए, यह ज़रूरी है कि आपके ऐप्लिकेशन ने मीडिया आइटम अपलोड किया हो. साथ ही, यह ज़रूरी है कि जिस उपयोगकर्ता की पुष्टि की गई है वह मौजूदा मालिक हो. ब्यौरे में 1,000 से ज़्यादा वर्ण नहीं हो सकते.
आराम
मीडिया आइटम की जानकारी को अपडेट करने के लिए, यहां पैच अनुरोध का हेडर दिया गया है:
PATCH https://photoslibrary.googleapis.com/v1/mediaItems/media-item-id?updateMask=description
इस अनुरोध से तय होता है कि कौनसी प्रॉपर्टी अपडेट हो रही हैं. इसके लिए, यूआरएल में updateMask
पैरामीटर से दिखाए गए फ़ील्ड मास्क को शामिल करें.
अनुरोध के मुख्य हिस्से में नई जानकारी शामिल करें:
{ "description": "new-media-item-description" }
कामयाब होने पर, जवाब अपडेट किया गया मीडिया आइटम दिखाता है:
{ "id": "media-item-id", "description": "new-media-item-description", "productUrl": "media-item-product-url", "baseUrl": "media-items-in-album", "mimeType": "mime-type-of-media", "mediaMetadata": { ... }, "contributorInfo": { ... }, "fileName": "item-filename" }
Java
try { // Update the description of the media item. // The new description must not be null. MediaItem updatedItem = photosLibraryClient.updateMediaItemDescription(mediaItem, "new-media-item-description"); } catch (ApiException e) { // Handle error }
PHP
try { // ID of the media item to update. $mediaItemId = "MEDIA_ITEM_ID"; // New description of the media item. $newDescription = "new-media-item-description"; // Update the description of the media item identified. $mediaItem = $photosLibraryClient->updateMediaItemDescription($mediaItemId, $newDescription); } catch (\Google\ApiCore\ApiException $e) { // Handle error }