Method: albums.batchRemoveMediaItems

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

برای آلبوم‌هایی که به اشتراک گذاشته می‌شوند، این عمل فقط برای آیتم‌های رسانه‌ای که توسط این کاربر به آلبوم اضافه شده‌اند یا اگر آلبوم توسط این کاربر ایجاد شده باشد، پشتیبانی می‌شود.

موفقیت جزئی پشتیبانی نمی شود. اگر یک مورد رسانه یا آلبوم نامعتبر مشخص شده باشد، کل درخواست ناموفق خواهد بود و هیچ اقدامی در آلبوم انجام نخواهد شد.

درخواست HTTP

POST https://photoslibrary.googleapis.com/v1/albums/{albumId}:batchRemoveMediaItems

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

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

پارامترها
albumId

string

مورد نیاز. شناسه Album که قرار است موارد رسانه از آن حذف شوند.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "mediaItemIds": [
    string
  ]
}
فیلدها
mediaItemIds[]

string

مورد نیاز. شناسه های MediaItem هایی که باید حذف شوند.

نباید دارای شناسه های مکرر باشد و نمی تواند خالی باشد. حداکثر تعداد آیتم های رسانه ای که می توان در یک تماس حذف کرد 50 مورد است.

بدن پاسخگو

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

محدوده مجوز

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

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