मीडिया आइटम मैनेज करें

मीडिया आइटम अपलोड करने के बाद, उन्हें 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
}