REST Resource: mediaItems

Ресурс: MediaItem

Представление элемента мультимедиа (например, фото или видео) в 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 "Zulu" с разрешением в наносекунды и до девяти дробных цифр. Примеры: "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

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

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