Method: albums.batchAddMediaItems

Добавляет в альбом один или несколько мультимедийных элементов из библиотеки Google Фото пользователя. Медиа-элементы и альбомы должны быть созданы разработчиком через API.

Медиа-элементы добавляются в конец альбома. Если задано несколько элементов мультимедиа, они добавляются в порядке, указанном в этом вызове.

Каждый альбом может содержать до 20 000 медиа-элементов.

В альбом можно добавить только те медиа-элементы, которые находятся в библиотеке пользователя. Для альбомов, к которым предоставлен общий доступ, альбом должен либо принадлежать пользователю, либо пользователь должен присоединиться к альбому в качестве соавтора.

Частичный успех не поддерживается. Весь запрос завершится ошибкой, если указан недопустимый элемент мультимедиа или альбом.

HTTP-запрос

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

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
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