Method: mediaItems.batchCreate

Tworzy co najmniej 1 element multimedialny w bibliotece Zdjęć Google użytkownika.

To drugi etap tworzenia elementu multimedialnego. Szczegółowe informacje o kroku 1, czyli przesyłaniu nieprzetworzonych bajtów na serwer Google, znajdziesz w sekcji Przesyłanie multimediów.

To wywołanie dodaje element multimedialny do biblioteki. Jeśli album id jest określony, wywołanie spowoduje dodanie do niego elementu multimedialnego. Każdy album może zawierać maksymalnie 20 tysięcy elementów multimedialnych. Domyślnie element multimedialny zostanie dodany na końcu biblioteki lub albumu.

Jeśli określisz zarówno album id, jak i pozycję, element multimedialny zostanie dodany do albumu na określonej pozycji.

Jeśli wywołanie zawiera wiele elementów multimedialnych, są one dodawane na określonej pozycji. Jeśli tworzysz element multimedialny w albumie udostępnionym, w którym nie jesteś właścicielem, nie możesz go umieścić. Spowoduje to błąd BAD REQUEST.

Żądanie HTTP

POST https://photoslibrary.googleapis.com/v1/mediaItems:batchCreate

Adres URL używa składni transkodowania gRPC.

Treść żądania

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

Zapis JSON 
{
  "albumId": string,
  "newMediaItems": [
    {
      object (NewMediaItem)
    }
  ],
  "albumPosition": {
    object (AlbumPosition)
  }
}
Pola
albumId

string

Identyfikator albumu, do którego zostały dodane elementy multimedialne. Elementy multimedialne zostaną też dodane do biblioteki użytkownika. To pole jest opcjonalne.
newMediaItems[]

object (NewMediaItem)

Wymagane. Lista elementów multimedialnych do utworzenia. Maksymalnie 50 elementów multimedialnych na połączenie.
albumPosition

object (AlbumPosition)

Miejsce w albumie, do którego zostały dodane elementy multimedialne. Jeśli nie podasz żadnej opcji, elementy multimedialne zostaną dodane na końcu albumu (zgodnie z domyślną wartością, czyli LAST_IN_ALBUM). Jeśli to pole jest ustawione, a albumId nie jest określony, żądanie kończy się niepowodzeniem. Prośba zakończy się też niepowodzeniem, jeśli ustawisz wartość tego pola i nie jesteś właścicielem albumu udostępnionego.

Treść odpowiedzi

Utworzono listę elementów multimedialnych.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "newMediaItemResults": [
    {
      object (NewMediaItemResult)
    }
  ]
}
Pola
newMediaItemResults[]

object (NewMediaItemResult)

Tylko dane wyjściowe. Utworzono listę elementów multimedialnych.

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

NewMediaItem

Nowy element multimedialny utworzony na koncie Zdjęć Google użytkownika.

Zapis JSON 
{
  "description": string,

  // Union field new_media_item_type can be only one of the following:
  "simpleMediaItem": {
    object (SimpleMediaItem)
  }
  // End of list of possible types for union field new_media_item_type.
}
Pola
description

string

Opis elementu multimedialnego. Jest on wyświetlany użytkownikowi w sekcji z informacjami o elemencie w aplikacji Zdjęcia Google. Nie może zawierać więcej niż 1000 znaków. Uwzględniaj tylko tekst napisany przez użytkowników. Opisy powinny dawać kontekst i pomagać użytkownikom w zrozumieniu multimediów. Nie dodawaj automatycznie wygenerowanych ciągów znaków, takich jak nazwy plików, tagi czy inne metadane.
Pole sumy new_media_item_type. Nowy element multimedialny może być różnego rodzaju – zależy to od ścieżki przesyłania. Obecnie obsługiwane przesyłanie korzysta tylko z prostej ścieżki elementu multimedialnego. new_media_item_type może mieć tylko jedną z tych wartości:
simpleMediaItem

object (SimpleMediaItem)

Nowy element multimedialny, który został przesłany za pomocą dołączonego elementu uploadToken.

SimpleMediaItem

Prosty element multimedialny, który ma zostać utworzony w Zdjęciach Google za pomocą tokena przesyłania.

Zapis JSON 
{
  "uploadToken": string,
  "fileName": string
}
Pola
uploadToken

string

Token identyfikujący bajty multimediów, które zostały przesłane do Google.
fileName

string

Nazwa pliku z rozszerzeniem elementu multimedialnego. Jest on wyświetlany użytkownikowi w Zdjęciach Google. Jeśli skonfigurujesz to pole, nazwa pliku określona podczas procesu przesyłania bajtów będzie ignorowana. Nazwa pliku, w tym jego rozszerzenie, nie powinna mieć więcej niż 255 znaków. To pole jest opcjonalne.

NewMediaItemResult

Wynik tworzenia nowego elementu multimedialnego.

Zapis JSON 
{
  "uploadToken": string,
  "status": {
    object (Status)
  },
  "mediaItem": {
    object (MediaItem)
  }
}
Pola
uploadToken

string

Token przesyłania użyty do utworzenia tego nowego (prostego) elementu multimedialnego. Wartość podawana tylko wtedy, gdy element multimedialny jest prosty i wymaga 1 tokena przesyłania.
status

object (Status)

Jeśli podczas tworzenia tego elementu multimedialnego wystąpił błąd, w tym polu znajdą się informacje dotyczące tego błędu. Szczegółowe informacje na temat tego pola znajdziesz w sekcji Stan.
mediaItem

object (MediaItem)

Element multimedialny został utworzony za pomocą tokena przesyłania. Ta wartość jest wypełniona, jeśli nie wystąpiły żadne błędy i element multimedialny został utworzony.