Dodaje do albumu co najmniej jeden element multimedialny z biblioteki Zdjęć Google użytkownika. Elementy multimedialne i albumy muszą zostać utworzone przez programistę za pomocą interfejsu API.
Elementy multimedialne są dodawane na końcu albumu. Jeśli podano wiele elementów multimedialnych, są one dodawane w kolejności określonej w tym wywołaniu.
Każdy album może zawierać do 20 000 elementów multimedialnych.
Do albumu można dodać tylko elementy multimedialne znajdujące się w bibliotece użytkownika. W przypadku albumów, które są udostępnione, album musi należeć do użytkownika lub dołączyć do niego jako współpracownik.
Częściowy sukces nie jest obsługiwany. Żądanie się nie powiedzie, jeśli określisz nieprawidłowy element multimedialny lub album.
Żądanie HTTP
POST https://photoslibrary.googleapis.com/v1/albums/{albumId}:batchAddMediaItems
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
albumId |
To pole jest wymagane. Identyfikator elementu ( |
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "mediaItemIds": [ string ] } |
Pola | |
---|---|
mediaItemIds[] |
To pole jest wymagane. Identyfikatory elementów |
Treść odpowiedzi
Jeśli operacja się uda, treść odpowiedzi będzie pusta.
Zakresy autoryzacji
Wymaga jednego z tych zakresów OAuth:
https://www.googleapis.com/auth/photoslibrary
https://www.googleapis.com/auth/photoslibrary.appendonly
https://www.googleapis.com/auth/photoslibrary.sharing