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

یک یا چند مورد رسانه ایجاد شده از برنامه را در کتابخانه 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.appendonly
  • https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata