REST Resource: mediaItems

Zasób: PickedMediaItem

Reprezentacja zdjęcia lub filmu wybranego przez użytkownika.

Zapis JSON
{
  "id": string,
  "createTime": string,
  "type": enum (Type),
  "mediaFile": {
    object (MediaFile)
  }
}
Pola
id

string

Identyfikator elementu multimedialnego.

Jest to stały identyfikator, którego można używać między sesjami do identyfikowania tego elementu multimedialnego.

createTime

string (Timestamp format)

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

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane 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".

type

enum (Type)

Typ tego elementu multimedialnego.

mediaFile

object (MediaFile)

Plik multimedialny, który stanowi ten element multimedialny.

Typ

Typ elementu multimedialnego.

Wartości w polu enum
TYPE_UNSPECIFIED Typ nie został określony.
PHOTO Element multimedialny reprezentuje zdjęcie.
VIDEO Element multimedialny reprezentuje film.

MediaFile

Reprezentacja pliku multimedialnego.

Zapis JSON
{
  "baseUrl": string,
  "mimeType": string,
  "filename": string,
  "mediaFileMetadata": {
    object (MediaFileMetadata)
  }
}
Pola
baseUrl

string

Adres URL do pobrania bajtów pliku multimedialnego.

Aby pobrać plik multimedialny, klient interfejsu API musi dodać do tego adresu URL parametry określone w dokumentacji dla deweloperó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 pliku multimedialnego. Na przykład: image/jpeg.

filename

string

Nazwa pliku multimedialnego.

mediaFileMetadata

object (MediaFileMetadata)

metadane związane z plikiem multimedialnym, takie jak wysokość i szerokość;

MediaFileMetadata

Metadane pliku multimedialnego.

Zapis JSON
{
  "width": integer,
  "height": integer,
  "cameraMake": string,
  "cameraModel": string,

  // Union field metadata can be only one of the following:
  "photoMetadata": {
    object (PhotoMetadata)
  },
  "videoMetadata": {
    object (VideoMetadata)
  }
  // End of list of possible types for union field metadata.
}
Pola
width

integer

Oryginalna szerokość pliku multimedialnego (w pikselach).

height

integer

Oryginalna wysokość pliku multimedialnego (w pikselach).

cameraMake

string

Marka aparatu, którym zarejestrowano multimedia.

cameraModel

string

Model aparatu, którym zarejestrowano multimedia.

Pole zbiorcze metadata. Metadane pliku multimedialnego specyficzne dla jego typu. metadata może mieć tylko jedną z tych wartości:
photoMetadata

object (PhotoMetadata)

Metadane typu multimediów ze zdjęciami.

videoMetadata

object (VideoMetadata)

Metadane typu multimediów wideo.

PhotoMetadata

Metadane dotyczące konkretnego zdjęcia, takie jak ISO, ogniskowa i czas ekspozycji.

Niektóre z tych pól mogą nie być ustawione.

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

number

Ogniskowa obiektywu aparatu, którym zostało zrobione zdjęcie.

apertureFNumber

number

Wartość przysłony obiektywu aparatu, którym zostało zrobione zdjęcie.

isoEquivalent

integer

Czułość ISO aparatu, którym zrobiono zdjęcie.

exposureTime

string (Duration format)

Czas ekspozycji przysłony aparatu podczas robienia zdjęcia.

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

VideoMetadata

Metadane dotyczące konkretnego filmu. Na przykład fps.

Zapis JSON
{
  "fps": number,
  "processingStatus": enum (VideoProcessingStatus)
}
Pola
fps

number

Liczba klatek filmu.

processingStatus

enum (VideoProcessingStatus)

Stan przetwarzania filmu.

VideoProcessingStatus

Stan przetwarzania filmu przechowywanego w Zdjęciach Google.

Wartości w polu enum
UNSPECIFIED Stan przetwarzania filmu nie jest określony.
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 jest on gotowy do obejrzenia.

Próba pobrania filmu, który nie jest w stanie READY, może się nie powieść.

FAILED Coś poszło nie tak i nie udało się przetworzyć filmu.

Metody

list

Zwraca listę plików multimedialnych wybranych przez użytkownika podczas określonej sesji.