Method: mediaItems.patch

مورد رسانه را با id مشخص شده به روز کنید. فقط فیلدهای id و description آیتم رسانه خوانده می شود. آیتم رسانه باید توسط توسعه دهنده از طریق API ایجاد شده باشد و باید متعلق به کاربر باشد.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
mediaItem.id

string

شناسه مورد رسانه. این یک شناسه ثابت است که می تواند بین جلسات برای شناسایی این آیتم رسانه استفاده شود.

پارامترهای پرس و جو

مولفه های
updateMask

string ( FieldMask format)

ضروری. فیلدهایی را در مورد رسانه ارائه شده برای به روز رسانی مشخص کنید. تنها مقدار معتبر description است.

این فهرستی از نام‌های فیلدهای کاملاً واجد شرایط با کاما است. مثال: "user.displayName,photo" .

درخواست بدن

بدنه درخواست شامل یک نمونه از MediaItem است.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از MediaItem است.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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