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 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. Dołącz tylko tekst napisany przez użytkowników. Opisy powinny dodawać kontekst i pomagać użytkownikom zrozumieć media. 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 '=w2048-h1024' spowoduje ustawienie wymiarów elementu multimedialnego typu zdjęcie na 2048 pikseli szerokości i 1024 pikseli 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 ta informacja jest dostępna tylko wtedy, gdy używasz parametru mediaItems.search z identyfikatorem albumu udostępnionego. Album musi zostać utworzony przez Twoją aplikację, a Ty musisz mieć uprawnienia do udostępniania.
filename

string

Nazwa pliku elementu multimedialnego. Będzie ona widoczna dla użytkownika 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 (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" i "2014-10-02T15:01:23.045123456Z".
width

string (int64 format)

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

string (int64 format)

Oryginalna wysokość elementu multimedialnego (w pikselach).
Pole sumy metadata. Metadane elementu multimedialnego charakterystyczne dla jego typu mediów. metadata może mieć tylko jedną z tych wartości:
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 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 zostało zrobione 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

ISO aparatu, w którym wykonano 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 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ż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 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ę elementów multimedialnych dla określonych identyfikatorów elementów multimedialnych.

get

 Zwraca element multimedialny o podanym identyfikatorze elementu multimedialnego.

list

 Wyświetla wszystkie elementy multimedialne z biblioteki Zdjęć Google użytkownika.

patch

 Zaktualizuj element multimedialny za pomocą określonego elementu id.
Wyszukuje elementów multimedialnych w bibliotece Zdjęć Google użytkownika.