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 Фото).

Использует 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" .

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 Фото пользователя.