REST Resource: mediaItems

Ресурс: PickedMediaItem

Представление фотографии или видео, выбранного пользователем.

JSON-представление 
{
  "id": string,
  "createTime": string,
  "type": enum (Type),
  "mediaFile": {
    object (MediaFile)
  }
}
Поля
id

string

Идентификатор медиа-элемента.

Это постоянный идентификатор, который можно использовать между сеансами для идентификации данного элемента мультимедиа.

createTime

string ( Timestamp format)

Время создания медиафайла (а не время его загрузки в Google Фото).

Использует RFC 3339, согласно которому сгенерированный вывод всегда будет нормализован по оси Z и содержать 0, 3, 6 или 9 знаков после запятой. Также допускаются смещения, отличные от «Z». Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

type

enum ( Type )

Тип данного медиа-элемента.

mediaFile

object ( MediaFile )

Медиа-файл, составляющий данный медиа-элемент.

Тип

Тип медиа-элемента.

Перечисления
TYPE_UNSPECIFIED Тип не указан.
PHOTO Медиа-элемент представляет собой фотографию.
VIDEO Медиа-элемент представляет собой видео.

МедиаФайл

Представление медиа-файла.

JSON-представление 
{
  "baseUrl": string,
  "mimeType": string,
  "filename": string,
  "mediaFileMetadata": {
    object (MediaFileMetadata)
  }
}
Поля
baseUrl

string

URL для извлечения байтов медиафайла.

Чтобы загрузить медиафайл, клиент API должен добавить к этому URL параметры, указанные в документации разработчика.

Например, '=w2048-h1024' установит размеры элемента мультимедиа типа «фотография» следующим образом: ширина — 2048 пикселей, а высота — 1024 пикселя.

mimeType

string

MIME-тип медиафайла. Например, image/jpeg .

filename

string

Имя файла мультимедиа.

mediaFileMetadata

object ( MediaFileMetadata )

Метаданные, относящиеся к медиафайлу, такие как высота и ширина.

MediaFileMetadata

Метаданные о медиафайле.

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.
}
Поля
width

integer

Исходная ширина (в пикселях) медиафайла.

height

integer

Исходная высота (в пикселях) медиафайла.

cameraMake

string

Марка камеры, с помощью которой был сделан носитель.

cameraModel

string

Модель камеры, с помощью которой был сделан снимок.

metadata поля объединения. Метаданные для медиафайла, относящиеся к его типу носителя. metadata могут быть только одним из следующих:
photoMetadata

object ( PhotoMetadata )

Метаданные для типа фотоносителя.

videoMetadata

object ( VideoMetadata )

Метаданные для типа видеоносителя.

ФотоМетаданные

Метаданные, относящиеся к фотографии, такие как ISO, фокусное расстояние и время экспозиции.

Некоторые из этих полей могут быть не заданы.

JSON-представление 
{
  "focalLength": number,
  "apertureFNumber": number,
  "isoEquivalent": integer,
  "exposureTime": string
}
Поля
focalLength

number

Фокусное расстояние объектива камеры, с помощью которой была сделана фотография.

apertureFNumber

number

Числовое значение диафрагмы f объектива камеры, с помощью которой была сделана фотография.

isoEquivalent

integer

ISO камеры, с помощью которой была сделана фотография.

exposureTime

string ( Duration format)

Время выдержки диафрагмы камеры в момент съемки фотографии.

Длительность в секундах, содержащая до девяти знаков после запятой, заканчивается на « s ». Пример: "3.5s" .

ВидеоМетаданные

Метаданные, относящиеся к видео. Например, частота кадров в секунду.

JSON-представление 
{
  "fps": number,
  "processingStatus": enum (VideoProcessingStatus)
}
Поля
fps

number

Частота кадров видео.

processingStatus

enum ( VideoProcessingStatus )

Статус обработки видео.

Статус обработки видео

Статус обработки видео, сохраненного в Google Фото.

Перечисления
UNSPECIFIED Статус обработки видео не указан.
PROCESSING

Видео обрабатывается.

Пользователь видит значок этого видео в приложении Google Фото, однако воспроизвести его пока невозможно.

READY

Обработка видео завершена, и теперь видео готово к просмотру.

Попытка загрузить видео, не находящееся в состоянии READY , может завершиться неудачей.

FAILED Что-то пошло не так, и видео не удалось обработать.

Методы

list

 Возвращает список элементов мультимедиа, выбранных пользователем во время указанного сеанса.