Method: albums.batchAddMediaItems

Dodaje do albumu co najmniej 1 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ępniane, album musi należeć do użytkownika lub dołączyć do niego jako współpracownika.

Częściowy sukces nie jest obsługiwany. Jeśli określisz nieprawidłowy element multimedialny lub nieprawidłowy album, całe żądanie zakończy się niepowodzeniem.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
albumId

string

Wymagane. Identyfikator Album, do którego są dodawane elementy multimedialne.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "mediaItemIds": [
    string
  ]
}
Pola
mediaItemIds[]

string

Wymagane. Identyfikatory elementów MediaItem, które mają zostać dodane. W jednym wywołaniu można dodać maksymalnie 50 elementów multimedialnych.

Treść odpowiedzi

Jeśli operacja się uda, treść odpowiedzi będzie pusta.

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu OAuth:

  • https://www.googleapis.com/auth/photoslibrary
  • https://www.googleapis.com/auth/photoslibrary.appendonly
  • https://www.googleapis.com/auth/photoslibrary.sharing