Добавляет в альбом один или несколько медиа-элементов из библиотеки Google Фото пользователя. Медиа-элементы и альбомы должны быть созданы разработчиком через API.
Медиа-элементы добавляются в конец альбома. Если задано несколько элементов мультимедиа, они добавляются в порядке, указанном в этом вызове.
Каждый альбом может содержать до 20 000 медиа-элементов.
В альбом можно добавить только элементы мультимедиа, которые находятся в библиотеке пользователя. Для альбомов, к которым предоставлен общий доступ, альбом должен либо принадлежать пользователю, либо пользователь должен присоединиться к альбому в качестве соавтора.
Частичный успех не поддерживается. Весь запрос завершится ошибкой, если указан недопустимый элемент мультимедиа или альбом.
HTTP-запрос
POST https://photoslibrary.googleapis.com/v1/albums/{albumId}:batchAddMediaItems
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры | |
---|---|
albumId | Необходимый. Идентификатор |
Тело запроса
Тело запроса содержит данные следующей структуры:
JSON-представление |
---|
{ "mediaItemIds": [ string ] } |
Поля | |
---|---|
mediaItemIds[] | Необходимый. Идентификаторы добавляемых объектов |
Тело ответа
В случае успеха тело ответа пустое.
Области авторизации
Требуется одна из следующих областей OAuth:
-
https://www.googleapis.com/auth/photoslibrary
-
https://www.googleapis.com/auth/photoslibrary.appendonly
-
https://www.googleapis.com/auth/photoslibrary.sharing