علاوه بر دسترسی و بازیابی آیتم های رسانه پس از آپلود ، می توانید توضیحات آنها را نیز تغییر دهید.
محدوده مجوز مورد نیاز
تغییر توضیحات محتوای ایجاد شده توسط برنامه به محدوده 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" }