موارد رسانه ای را مدیریت کنید

علاوه بر دسترسی به موارد رسانه پس از بارگذاری آنها، می توانید توضیحات آنها را نیز تغییر دهید.

محدوده مجوز مورد نیاز

برای تغییر توضیحات موارد رسانه پس از ایجاد آنها، از محدوده photoslibrary.edit.appcreateddata استفاده کنید.

تغییر توضیحات آیتم های رسانه

برای تغییر توضیحات یک مورد رسانه، یک media items update call با شناسه مورد رسانه برقرار کنید و توضیحات جدید را در درخواست اضافه کنید.

برای تغییر توضیحات یک مورد رسانه، برنامه شما باید مورد رسانه را آپلود کرده باشد و کاربر تأیید شده فعلی باید مالک باشد. طول توضیحات نمی تواند بیش از 1000 کاراکتر باشد.

باقی مانده

در اینجا یک هدر درخواست PATCH برای به روز رسانی توضیحات مورد رسانه وجود دارد:

PATCH https://photoslibrary.googleapis.com/v1/mediaItems/media-item-id?updateMask=description

این درخواست با اضافه کردن یک فیلد ماسک که با پارامتر updateMask در URL نشان داده شده است، مشخص می کند که چه ویژگی هایی به روز می شوند.

شرح جدید را در متن درخواست درج کنید:

{
  "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"
}

جاوا

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
}