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órego można używać w kolejnych sesjach do identyfikowania tego elementu multimedialnego.
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.
productUrl

string

Adres URL elementu multimedialnego w Zdjęciach Google. Ten link jest dostępny tylko wtedy, gdy użytkownik jest zalogowany. Po pobraniu z wyszukiwania albumu adres URL wskazuje element wewnątrz albumu.
baseUrl

string

Adres URL w bajtach elementu multimedialnego. Nie należy używać tych parametrów w niezmienionej postaci. Parametry należy dołączyć do tego adresu URL przed użyciem. Pełną listę obsługiwanych parametrów znajdziesz w dokumentacji dla programistów. Na przykład '=w2048-h1024' ustawi wymiary elementu multimedialnego typu zdjęcie na szerokość 2048 pikseli i wysokość 1024 pikseli.
mimeType

string

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

object (MediaMetadata)

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

object (ContributorInfo)

Informacje o użytkowniku, który dodał ten element multimedialny. Pamiętaj, że jest to uwzględniane tylko w przypadku korzystania z elementu mediaItems.search z identyfikatorem albumu udostępnionego. Album musi zostać utworzony przez Twoją aplikację i musisz mieć dla niego włączony zakres udostępniania.
filename

string

Nazwa pliku elementu multimedialnego. Będzie on widoczny w sekcji informacji o elemencie 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 (a nie momentu przesłania go do Zdjęć Google).

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

string (int64 format)

Pierwotna szerokość elementu multimedialnego (w pikselach).
height

string (int64 format)

Pierwotna wysokość (w pikselach) elementu multimedialnego.
Pole sumy metadata. Metadane elementu multimedialnego powiązane z reprezentowanym przez niego typem multimediów. metadata może być tylko jedną z tych wartości:
photo

object (Photo)

Metadane typu multimediów ze zdjęciami.
video

object (Video)

Metadane typu mediów wideo.

Zdjęcie

Metadane konkretnego zdjęcia, takie jak ISO, ogniskowa i czas naświetlania. 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, za pomocą którego zrobiono zdjęcie.
focalLength

number

Ogniskowa obiektywu aparatu, którym zrobiono zdjęcie.
apertureFNumber

number

Wartość przysłony – wartość obiektywu aparatu, którym zrobiono zdjęcie.
isoEquivalent

integer

Wartość ISO aparatu, z którego zrobiono zdjęcie.
exposureTime

string (Duration format)

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

Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „s”. Przykład: "3.5s".

Wideo

Metadane specyficzne dla 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 aparatu, za pomocą którego nagrano film.
cameraModel

string

Model kamery, za pomocą 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 jeszcze go odtworzyć.
READY Przetwarzanie filmu zostało zakończone i można go już wyświetlać. Ważne: próba pobrania filmu, który nie jest w stanie GOTOWY, może się nie powieść.
FAILED Coś poszło nie tak i nie udało się przetworzyć filmu.

ContributorInfo

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

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

string

adres URL zdjęcia profilowego współtwórcy.
displayName

string

Wyświetlana nazwa współtwórcy.

Metody

batchCreate

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

batchGet

 Zwraca listę elementów multimedialnych dla określonych identyfikatorów elementów multimedialnych.

get

 Zwraca element multimedialny o podanym identyfikatorze.

list

 Wyświetlanie listy wszystkich elementów multimedialnych z biblioteki Zdjęć Google użytkownika

patch

 Zaktualizuj element multimedialny przy użyciu określonego elementu id.
Wyszukuje elementy multimedialne w bibliotece Zdjęć Google użytkownika.