Ресурс: MediaItem
Представление элемента мультимедиа (например, фото или видео) в 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 "Zulu" с разрешением в наносекунды и до девяти дробных цифр. Примеры: |
width | Исходная ширина (в пикселях) элемента мультимедиа. |
height | Исходная высота (в пикселях) элемента мультимедиа. |
metadata поля объединения. Метаданные для элемента мультимедиа, относящиеся к базовому типу мультимедиа, который он представляет. metadata могут быть только одним из следующих: | |
photo | Метаданные для фототипа носителя. |
video | Метаданные для видеотипа мультимедиа. |
Фото
Метаданные, относящиеся к фотографии, такие как ISO, фокусное расстояние и время экспозиции. Некоторые из этих полей могут быть пустыми или не включены.
Представление JSON |
---|
{ "cameraMake": string, "cameraModel": string, "focalLength": number, "apertureFNumber": number, "isoEquivalent": integer, "exposureTime": string } |
Поля | |
---|---|
cameraMake | Марка фотоаппарата, которым был сделан снимок. |
cameraModel | Модель фотоаппарата, которым было сделано фото. |
focalLength | Фокусное расстояние объектива камеры, с помощью которой был сделан снимок. |
apertureFNumber | Диафрагма f номер объектива камеры, с помощью которой был сделан снимок. |
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 Фото пользователя. |