Method: albums.batchAddMediaItems

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

آیتم های رسانه ای به انتهای آلبوم اضافه می شوند. اگر چندین مورد رسانه ای داده شود، به ترتیب مشخص شده در این فراخوان اضافه می شوند.

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

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

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

درخواست HTTP

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

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.appendonly
  • https://www.googleapis.com/auth/photoslibrary.sharing