REST Resource: mediaItems

Ресурс: Медиаитем

Представление мультимедийного элемента (например, фотографии или видео) в Google Фото.

JSON-представление
{
  "id": string,
  "description": string,
  "productUrl": string,
  "baseUrl": string,
  "mimeType": string,
  "mediaMetadata": {
    object (MediaMetadata)
  },
  "contributorInfo": {
    object (ContributorInfo)
  },
  "filename": string
}
Поля
id

string

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

description

string

Описание медиа-объекта. Это отображается пользователю в разделе информации об объекте в приложении Google Фото. Должно быть короче 1000 символов. Включайте только текст, написанный пользователями. Описания должны добавлять контекст и помогать пользователям понимать медиа. Не включайте автоматически сгенерированные строки, такие как имена файлов, теги и другие метаданные.

productUrl

string

URL-адрес Google Фото для медиа-элемента. Эта ссылка доступна пользователю, только если он вошел в систему. При получении из поиска по альбому URL-адрес указывает на элемент внутри альбома.

baseUrl

string

URL-адрес байтов элемента мультимедиа. Это не следует использовать как есть. Перед использованием к этому URL-адресу следует добавить параметры. Полный список поддерживаемых параметров см. в документации разработчика . Например, '=w2048-h1024' установит размеры медиа-элемента типа «фотография» на ширину 2048 пикселей и высоту 1024 пикселей.

mimeType

string

MIME-тип элемента мультимедиа. Например, image/jpeg .

mediaMetadata

object ( MediaMetadata )

Метаданные, относящиеся к элементу мультимедиа, например высота, ширина или время создания.

contributorInfo

object ( ContributorInfo )

Информация о пользователе, который добавил этот медиа-элемент. Обратите внимание, что это включается только при использовании mediaItems.search с идентификатором общего альбома. Альбом должен быть создан вашим приложением, и у вас должна быть область общего доступа.

filename

string

Имя файла медиа-элемента. Это отображается пользователю в разделе информации об объекте в приложении Google Фото.

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

Метаданные для элемента мультимедиа.

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

string ( Timestamp format)

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

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

width

string ( int64 format)

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

height

string ( int64 format)

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

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

object ( Photo )

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

video

object ( Video )

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

Фото

Метаданные, относящиеся к фотографии, например ISO, фокусное расстояние и время экспозиции. Некоторые из этих полей могут быть пустыми или не включены.

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

string

Марка фотоаппарата, которым было сделано фото.

cameraModel

string

Модель камеры, которой было сделано фото.

focalLength

number

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

apertureFNumber

number

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

isoEquivalent

integer

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

exposureTime

string ( Duration format)

Время экспозиции диафрагмы камеры во время съемки фотографии.

Длительность в секундах, содержащая до девяти дробных цифр и оканчивающаяся на « s ». Пример: "3.5s" .

видео

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

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

string

Марка камеры, которой было снято видео.

cameraModel

string

Модель камеры, которой было снято видео.

fps

number

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

status

enum ( VideoProcessingStatus )

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

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

Статус обработки видео, загружаемого в Google Фото.

Перечисления
UNSPECIFIED Статус обработки видео неизвестен.
PROCESSING Видео находится в обработке. Пользователь видит значок этого видео в приложении Google Фото; однако в нее еще нельзя играть.
READY Обработка видео завершена и теперь оно готово к просмотру. Важно: попытка загрузить видео, не находящееся в состоянии ГОТОВО, может оказаться неудачной.
FAILED Что-то пошло не так, и видео не удалось обработать.

Информация о вкладчике

Информация о пользователе, добавившем медиа-элемент. Обратите внимание, что эта информация включается только в том случае, если элемент мультимедиа находится в общем альбоме, созданном вашим приложением, и у вас есть область общего доступа.

JSON-представление
{
  "profilePictureBaseUrl": string,
  "displayName": string
}
Поля
profilePictureBaseUrl

string

URL-адрес изображения профиля автора.

displayName

string

Отображаемое имя участника.

Методы

batchCreate

 Создает один или несколько элементов мультимедиа в библиотеке Google Фото пользователя.

batchGet

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

get

 Возвращает элемент мультимедиа для указанного идентификатора элемента мультимедиа.

list

 Перечислите все медиа-элементы из библиотеки Google Фото пользователя.

patch

 Обновите элемент мультимедиа с указанным id .
Ищет медиа-элементы в библиотеке Google Фото пользователя.