Method: mediaItems.batchCreate

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

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

To wywołanie dodaje element multimedialny do biblioteki. Jeśli określono album id, wywołanie dodaje też element multimedialny do albumu. Każdy album może zawierać do 20 000 elementów multimedialnych. Domyślnie element multimedialny jest dodawany na końcu biblioteki lub albumu.

Jeśli zdefiniowano zarówno album id, jak i pozycję, element multimedialny zostanie dodany do albumu w określonym miejscu.

Jeśli wywołanie zawiera wiele elementów multimedialnych, są one dodawane w określonym miejscu. Jeśli tworzysz element multimedialny w albumie udostępnionym, którego nie jesteś właścicielem, nie możesz go określić. Spowoduje to wystąpienie błędu 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 dodano elementy multimedialne. Elementy multimedialne zostaną też dodane do biblioteki użytkownika. To pole jest opcjonalne.
newMediaItems[]

object (NewMediaItem)

To pole jest wymagane. Lista elementów multimedialnych do utworzenia. Maksymalnie 50 elementów multimedialnych na połączenie.
albumPosition

object (AlbumPosition)

Pozycja w albumie, do której są dodane elementy multimedialne. Jeśli tego nie zrobisz, elementy multimedialne zostaną dodane na końcu albumu (zgodnie z wartością domyślną, czyli LAST_IN_ALBUM). Żądanie nie powiedzie się, jeśli to pole zostanie ustawione, a albumId nie będzie określony. Żądanie nie zostanie też zrealizowane, jeśli ustawisz to pole i nie jesteś właścicielem albumu udostępnionego.

Treść odpowiedzi

Lista utworzonych 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. Lista utworzonych elementów multimedialnych.

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

NewMediaItem

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

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. Będzie on widoczny w sekcji informacji o elemencie w aplikacji Zdjęcia Google. Tekst musi być krótszy niż 1000 znaków. Podawaj tylko tekst napisany przez użytkowników. Opisy powinny uzupełniać kontekst i pomagać użytkownikom zrozumieć multimedia. Nie dodawaj żadnych 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 typu – zależy to od ścieżki przesyłania. Obecnie obsługiwane przesyłanie odbywa się tylko z użyciem prostej ścieżki elementu multimedialnego. new_media_item_type może być tylko jedną z tych wartości:
simpleMediaItem

object (SimpleMediaItem)

Nowy element multimedialny przesłano za pomocą dołączonego pliku uploadToken.

SimpleMediaItem

Prosty element multimedialny do utworzenia 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. Ten element jest widoczny dla użytkownika w Zdjęciach Google. Jeśli to pole jest ustawione, nazwa pliku podana podczas przesyłania bajtów jest ignorowana. Nazwa pliku (wraz z rozszerzeniem) nie powinna być dłuższa niż 255 znaków. To pole jest opcjonalne.

NewMediaItemResult

Wynik utworzenia nowego elementu multimedialnego.

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

string

Token przesyłania używany do utworzenia tego nowego (prostego) elementu multimedialnego. Pole wypełnione tylko wtedy, gdy element multimedialny jest prosty i wymaga pojedynczego tokena przesyłania.
status

object (Status)

Jeśli podczas tworzenia elementu multimedialnego wystąpił błąd, w tym polu pojawią się powiązane z nim informacje. Szczegółowe informacje o tym polu znajdziesz w sekcji Stan.
mediaItem

object (MediaItem)

Element multimedialny został utworzony za pomocą tokena przesyłania. Jeśli nie wystąpiły żadne błędy i element multimedialny został utworzony, to pole jest wypełniane.