REST Resource: mediaItems

Zasób: MediaItem

Reprezentacja 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 zasobu 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. 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.
productUrl

string

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

string

Adres URL bajtów elementu multimedialnego. Nie należy go używać w postaci, w której został podany. Przed użyciem do tego adresu URL należy dołączyć parametry. Pełną listę obsługiwanych parametrów znajdziesz w dokumentacji dla programistów. Na przykład '=w2048-h1024' spowoduje ustawienie wymiarów elementu multimedialnego typu zdjęcie na 2048 pikseli szerokości i 1024 piksele wysokości.
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 jest on uwzględniany tylko wtedy, gdy używasz mediaItems.search z identyfikatorem udostępnionego albumu. Album musi zostać utworzony przez Twoją aplikację, a Ty musisz mieć uprawnienia do 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, w którym multimedia zostały utworzone (a nie przesłane do Zdjęć Google).

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Dopuszczalne są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
width

string (int64 format)

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

string (int64 format)

Oryginalna wysokość (w pikselach) elementu multimedialnego.
Pole unii metadata. Metadane elementu multimedialnego dotyczące typu multimediów, które reprezentuje. metadata może być tylko jednym z tych elementów:
photo

object (Photo)

Metadane typu nośnika zdjęć.
video

object (Video)

Metadane typu multimediów wideo.

Zdjęcie

metadane dotyczące konkretnego zdjęcia, takie jak ISO, ogniskowa i czas naświetlania; Niektóre z tych pól mogą być puste lub nieobecne.

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

string

Marka aparatu, którym zostało zrobione zdjęcie.
cameraModel

string

Model aparatu, którym zostało zrobione zdjęcie.
focalLength

number

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

number

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

integer

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

string (Duration format)

Czas ekspozycji przysłony aparatu w momencie robienia zdjęcia.

Czas w sekundach z maksymalnie 9 miejscami po przecinku, zakończony literą „s”. Przykład: "3.5s".

Wideo

metadane dotyczące konkretnego filmu, np. liczba klatek na sekundę i stan przetwarzania; Niektóre z tych pól mogą być puste lub nieobecne.

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

string

Marka aparatu, którym nagrano film.
cameraModel

string

Model aparatu, którym 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że go jeszcze odtworzyć.
READY Przetwarzanie filmu zostało zakończone i możesz go teraz obejrzeć. 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 multimediów znajduje się w albumie udostępnionym utworzonym przez Twoją aplikację i masz uprawnienia do 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 co najmniej 1 element multimedialny w bibliotece Zdjęć Google użytkownika.

batchGet

 Zwraca listę utworzonych przez aplikację elementów multimedialnych dla podanych identyfikatorów elementów multimedialnych.

get

 Zwraca utworzony przez aplikację element multimedialny o określonym identyfikatorze.

list

 Lista wszystkich elementów multimedialnych utworzonych przez aplikację w bibliotece Zdjęć Google użytkownika.

patch

 Zaktualizuj utworzony przez aplikację element multimedialny, podając określoną wartość id.
Szuka w bibliotece Zdjęć Google użytkownika elementów multimedialnych utworzonych przez aplikację.