Method: mediaItems.batchCreate

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

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

Ta wywołania powoduje dodanie elementu multimedialnego do biblioteki. Jeśli zostanie podany album id, wywołanie spowoduje również dodanie elementu multimedialnego do albumu. 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 zdefiniowano album id i pozycję, element multimedialny zostanie dodany do albumu na wskazanej pozycji.

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 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 dodano elementy multimedialne. Elementy multimedialne są też dodawane 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)

Pozycja w albumie, w której dodano elementy multimedialne. Jeśli nie podasz żadnej opcji, elementy multimedialne zostaną dodane na końcu albumu (zgodnie z wartością domyślną, 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ę niepowodzeniem, jeśli ustawisz to pole, ale 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 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. Dołącz tylko tekst napisany przez użytkowników. Opisy powinny dodawać kontekst i pomagać użytkownikom w rozumieniu multimediów. Nie dodawaj żadnych automatycznie generowanych ciągów znaków, takich jak nazwy plików, tagi i inne metadane.
Pole unii new_media_item_type. Nowy element multimedialny może być różnych typów – zależy to od ścieżki przesyłania. Obecnie obsługiwane przesyłanie używa tylko prostej ścieżki do elementu multimedialnego. new_media_item_type może być tylko jednym z tych elementów:
simpleMediaItem

object (SimpleMediaItem)

nowy element multimedialny przesłany za pomocą dołączonego pliku 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 przesłane do Google.
fileName

string

Nazwa pliku z rozszerzeniem elementu multimedialnego. Jest on wyświetlany użytkownikowi w Zdjęciach Google. Jeśli to pole jest ustawione, nazwa pliku określona podczas procesu przesyłania bajtów jest ignorowana. Nazwa pliku, łącznie z rozszerzeniem, nie może 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. Wypełniony tylko wtedy, gdy element multimediów jest prosty i wymaga pojedynczego tokena przesyłania.
status

object (Status)

Jeśli podczas tworzenia tego elementu multimedialnego wystąpił błąd, w tym polu znajdują się informacje o tym błędzie. Szczegółowe informacje o tym polu znajdziesz w sekcji Stan.
mediaItem

object (MediaItem)

Element multimedialny utworzony za pomocą tokena przesyłania. Jest on wypełniony, jeśli nie wystąpiły żadne błędy i utworzono element multimedialny.