REST Resource: mediaItems

Zasób: MediaItem

Prezentacja elementu multimedialnego (np. zdjęcia lub filmu) w Zdjęciach Google.

Zapis JSON
{
  "id": string,
  "description": string,
  "productUrl": string,
  "baseUrl": string,
  "mimeType": string,
  "mediaMetadata": {
    object (MediaMetadata)
  },
  "contributorInfo": {
    object (ContributorInfo)
  },
  "filename": string
}
Pola
id

string

Identyfikator elementu multimedialnego. Jest to trwały identyfikator, który może być używany w różnych sesjach do identyfikacji danego elementu multimedialnego.

description

string

Opis elementu multimedialnego. Będzie ona widoczna dla użytkownika w sekcji informacji o elemencie w aplikacji Zdjęcia Google. Liczba znaków musi być mniejsza niż 1000. 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.

productUrl

string

Adres URL Zdjęć Google dla elementu multimedialnego. Ten link jest dostępny tylko wtedy, gdy użytkownik jest zalogowany. Po pobraniu albumu z wyników wyszukiwania adres URL wskazuje element w albumie.

baseUrl

string

Adres URL bajtów elementu multimedialnego. Nie należy używać tej właściwości w niezmienionej formie. Przed użyciem parametrów musisz je dołączyć do tego adresu URL. Pełną listę obsługiwanych parametrów znajdziesz w dokumentacji dla programistów. Na przykład funkcja '=w2048-h1024' ustawi wymiary elementu multimedialnego typu zdjęcie na szerokość 2048 pikseli i wysokość 1024 piksele.

mimeType

string

Typ MIME elementu multimedialnego. Na przykład: image/jpeg.

mediaMetadata

object (MediaMetadata)

Metadane związane z elementem multimedialnym, takie jak wysokość, szerokość lub czas utworzenia.

contributorInfo

object (ContributorInfo)

Informacje o użytkowniku, który dodał ten zasób multimedialny. Pamiętaj, że ta informacja jest dostępna tylko wtedy, gdy używasz parametru mediaItems.search z identyfikatorem albumu udostępnionego. Album musi zostać utworzony przez aplikację i musisz mieć zakres udostępniania.

filename

string

Nazwa pliku elementu multimedialnego. Jest on wyświetlany użytkownikowi w sekcji informacji o produkcie w aplikacji Zdjęcia Google.

MediaMetadata

Metadane elementu multimedialnego.

Zapis JSON
{
  "creationTime": string,
  "width": string,
  "height": string,

  // Union field metadata can be only one of the following:
  "photo": {
    object (Photo)
  },
  "video": {
    object (Video)
  }
  // End of list of possible types for union field metadata.
}
Pola
creationTime

string (Timestamp format)

Czas utworzenia elementu multimedialnego (nie momentu przesłania go do Zdjęć Google).

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

width

string (int64 format)

Oryginalna szerokość elementu multimedialnego (w pikselach).

height

string (int64 format)

Oryginalna wysokość (w pikselach) elementu multimedialnego.

Pole sumy metadata. Metadane elementu multimedialnego charakterystyczne dla jego typu mediów. metadata może być tylko jednym z tych elementów:
photo

object (Photo)

Metadane dla typu multimediów ze zdjęciami.

video

object (Video)

Metadane dotyczące typu multimediów wideo.

Zdjęcie

Metadane dotyczące zdjęcia, np. ISO, ogniskowa i czas ekspozycji. Niektóre z tych pól mogą mieć wartość null lub nie być uwzględnione.

Zapis JSON
{
  "cameraMake": string,
  "cameraModel": string,
  "focalLength": number,
  "apertureFNumber": number,
  "isoEquivalent": integer,
  "exposureTime": string
}
Pola
cameraMake

string

Marka aparatu, którym zrobiono zdjęcie.

cameraModel

string

Model aparatu, którym zrobiono zdjęcie.

focalLength

number

Ogniskowa obiektywu aparatu, przy użyciu którego zrobiono zdjęcie.

apertureFNumber

number

Numer przysłony f obiektywu aparatu, którym zrobiono zdjęcie.

isoEquivalent

integer

Wartość ISO aparatu, którym zrobiono zdjęcie.

exposureTime

string (Duration format)

Czas naświetlania przysłony aparatu podczas robienia zdjęcia.

Czas trwania w sekundach składający się z maksymalnie 9 cyfr po przecinku i kończący się „s”. Przykład: "3.5s".

Wideo

Metadane dotyczące filmu, np. liczba klatek na sekundę i stan przetwarzania. Niektóre z tych pól mogą mieć wartość null lub nie być uwzględnione.

Zapis JSON
{
  "cameraMake": string,
  "cameraModel": string,
  "fps": number,
  "status": enum (VideoProcessingStatus)
}
Pola
cameraMake

string

Marka kamery, przy użyciu której został nagrany film.

cameraModel

string

Model kamery, przy użyciu której nagrano film.

fps

number

Liczba klatek filmu.

status

enum (VideoProcessingStatus)

Stan przetwarzania filmu.

VideoProcessingStatus

Stan przetwarzania filmu przesyłanego do Zdjęć Google.

Wartości w polu enum
UNSPECIFIED Stan przetwarzania filmu jest nieznany.
PROCESSING Film jest przetwarzany. Użytkownik widzi ikonę tego filmu w aplikacji Zdjęcia Google. ale nie można jej jeszcze odtworzyć.
READY Przetwarzanie filmu zostało zakończone i można go już oglądać. Ważne: próba pobrania filmu, który nie jest w stanie GOTOWY, może się nie udać.
FAILED Coś poszło nie tak i nie udało się przetworzyć filmu.

ContributorInfo

Informacje o użytkowniku, który dodał element multimedialny. Pamiętaj, że te informacje są uwzględniane tylko wtedy, gdy element multimedialny znajduje się w albumie udostępnionym utworzonym przez Twoją aplikację i masz zakres udostępniania.

Zapis JSON
{
  "profilePictureBaseUrl": string,
  "displayName": string
}
Pola
profilePictureBaseUrl

string

Adres URL zdjęcia profilowego twórcy.

displayName

string

Wyświetlana nazwa współtwórcy.

Metody

batchCreate

batchGet

get

list

patch

Zaktualizuj element multimedialny za pomocą określonego atrybutu id.