Method: albums.batchAddMediaItems

Dodaje co najmniej 1 element multimediów z biblioteki Zdjęć Google użytkownika do albumu. Elementy multimedialne i albumy muszą zostać utworzone przez dewelopera 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ć maksymalnie 20 tysięcy elementów multimedialnych.

Do albumu można dodawać tylko elementy multimedialne znajdujące się w bibliotece użytkownika. W przypadku udostępnionych albumów użytkownik musi być ich właścicielem lub musi dołączyć do albumu jako współtwórca.

Częściowy sukces nie jest obsługiwany. Jeśli podany zostanie nieprawidłowy album lub nieprawidłowy element multimedialny, cała prośba 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 elementu multimedialnego (Album), do którego są dodane elementy multimedialne.

Treść żądania

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

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

string

Wymagane. Identyfikatory dodanych MediaItem. Maksymalna liczba elementów multimedialnych, które można dodać w jednym wywołaniu, to 50.

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