REST Resource: mediaItems

Ресурс: PickedMediaItem

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

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

string

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

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

createTime

string ( Timestamp format)

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

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

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 )

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

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

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

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

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

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

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