Ресурс: Медиаитем
Представление мультимедийного элемента (например, фотографии или видео) в Google Фото.
JSON-представление |
---|
{ "id": string, "description": string, "productUrl": string, "baseUrl": string, "mimeType": string, "mediaMetadata": { object ( |
Поля | |
---|---|
id | Идентификатор медиа-элемента. Это постоянный идентификатор, который можно использовать между сеансами для идентификации данного мультимедийного элемента. |
description | Описание медиа-объекта. Это отображается пользователю в разделе информации об объекте в приложении Google Фото. Должно быть короче 1000 символов. Включайте только текст, написанный пользователями. Описания должны добавлять контекст и помогать пользователям понимать медиа. Не включайте автоматически сгенерированные строки, такие как имена файлов, теги и другие метаданные. |
productUrl | URL-адрес Google Фото для медиа-элемента. Эта ссылка доступна пользователю, только если он вошел в систему. При получении из поиска по альбому URL-адрес указывает на элемент внутри альбома. |
baseUrl | URL-адрес байтов элемента мультимедиа. Это не следует использовать как есть. Перед использованием к этому URL-адресу следует добавить параметры. Полный список поддерживаемых параметров см. в документации разработчика . Например, |
mimeType | MIME-тип элемента мультимедиа. Например, |
mediaMetadata | Метаданные, относящиеся к элементу мультимедиа, например высота, ширина или время создания. |
contributorInfo | Информация о пользователе, который добавил этот медиа-элемент. Обратите внимание, что это включается только при использовании |
filename | Имя файла медиа-элемента. Это отображается пользователю в разделе информации об объекте в приложении Google Фото. |
МедиаМетаданные
Метаданные для элемента мультимедиа.
JSON-представление |
---|
{ "creationTime": string, "width": string, "height": string, // Union field |
Поля | |
---|---|
creationTime | Время, когда медиа-элемент был впервые создан (а не когда он был загружен в Google Фото). Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: |
width | Исходная ширина (в пикселях) медиа-элемента. |
height | Исходная высота (в пикселях) элемента мультимедиа. |
metadata поля объединения. Метаданные для элемента мультимедиа, относящиеся к базовому типу мультимедиа, который он представляет. metadata могут быть только одним из следующих: | |
photo | Метаданные для типа носителя фотографий. |
video | Метаданные для типа видео. |
Фото
Метаданные, относящиеся к фотографии, например ISO, фокусное расстояние и время экспозиции. Некоторые из этих полей могут быть пустыми или не включены.
JSON-представление |
---|
{ "cameraMake": string, "cameraModel": string, "focalLength": number, "apertureFNumber": number, "isoEquivalent": integer, "exposureTime": string } |
Поля | |
---|---|
cameraMake | Марка фотоаппарата, которым было сделано фото. |
cameraModel | Модель камеры, которой было сделано фото. |
focalLength | Фокусное расстояние объектива камеры, с помощью которой была сделана фотография. |
apertureFNumber | Номер диафрагмы объектива камеры, с помощью которой была сделана фотография. |
isoEquivalent | ISO камеры, с помощью которой была сделана фотография. |
exposureTime | Время экспозиции диафрагмы камеры во время съемки фотографии. Длительность в секундах, содержащая до девяти дробных цифр и оканчивающаяся на « |
Видео
Метаданные, относящиеся к видео, например частота кадров и статус обработки. Некоторые из этих полей могут быть пустыми или не включены.
JSON-представление |
---|
{
"cameraMake": string,
"cameraModel": string,
"fps": number,
"status": enum ( |
Поля | |
---|---|
cameraMake | Марка камеры, которой было снято видео. |
cameraModel | Модель камеры, которой было снято видео. |
fps | Частота кадров видео. |
status | Статус обработки видео. |
Статус обработки видео
Статус обработки видео, загружаемого в Google Фото.
Перечисления | |
---|---|
UNSPECIFIED | Статус обработки видео неизвестен. |
PROCESSING | Видео находится в обработке. Пользователь видит значок этого видео в приложении Google Фото; однако в нее еще нельзя играть. |
READY | Обработка видео завершена и теперь оно готово к просмотру. Важно: попытка загрузить видео, не находящееся в состоянии ГОТОВО, может оказаться неудачной. |
FAILED | Что-то пошло не так, и видео не удалось обработать. |
Информация о вкладчике
Информация о пользователе, добавившем медиа-элемент. Обратите внимание, что эта информация включается только в том случае, если элемент мультимедиа находится в общем альбоме, созданном вашим приложением, и у вас есть область общего доступа.
JSON-представление |
---|
{ "profilePictureBaseUrl": string, "displayName": string } |
Поля | |
---|---|
profilePictureBaseUrl | URL-адрес изображения профиля автора. |
displayName | Отображаемое имя участника. |
Методы | |
---|---|
| Создает один или несколько элементов мультимедиа в библиотеке Google Фото пользователя. |
| Возвращает список элементов мультимедиа для указанных идентификаторов элементов мультимедиа. |
| Возвращает элемент мультимедиа для указанного идентификатора элемента мультимедиа. |
| Перечислите все медиа-элементы из библиотеки Google Фото пользователя. |
| Обновите элемент мультимедиа с указанным id . |
| Ищет медиа-элементы в библиотеке Google Фото пользователя. |