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