资源:MediaItem
表示 Google 相册中的媒体内容(例如照片或视频)。
JSON 表示法 |
---|
{ "id": string, "description": string, "productUrl": string, "baseUrl": string, "mimeType": string, "mediaMetadata": { object ( |
字段 | |
---|---|
id |
媒体项的标识符。这是一个永久标识符,可用于在会话之间标识此媒体项。 |
description |
媒体项的说明。此信息会在 Google 相册应用的内容信息部分向用户显示。长度必须少于 1000 个字符。仅包含用户撰写的文字。说明应该添加背景信息,帮助用户了解媒体内容。请勿包含任何自动生成的字符串,例如文件名、标签和其他元数据。 |
productUrl |
媒体内容的 Google 相册网址。用户只有在登录后才能使用此链接。从影集搜索中检索时,该网址将指向影集内的项。 |
baseUrl |
指向媒体内容字节的网址。您不能按原样使用此网址。在使用之前,应将参数附加到此网址。如需查看受支持参数的完整列表,请参阅开发者文档。例如, |
mimeType |
媒体内容的 MIME 类型。例如 |
mediaMetadata |
与媒体项相关的元数据,例如高度、宽度或创建时间。 |
contributorInfo |
添加此媒体项的用户的相关信息。请注意,仅当将 |
filename |
媒体内容的文件名。此内容会在 Google 相册应用的内容信息部分显示。 |
MediaMetadata
媒体项的元数据。
JSON 表示法 |
---|
{ "creationTime": string, "width": string, "height": string, // Union field |
字段 | |
---|---|
creationTime |
媒体内容的创建时间(并非上传到 Google 相册的时间)。 采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式的时间戳,采用纳秒级精度,最多包含九个小数位。示例: |
width |
媒体项的原始宽度(以像素为单位)。 |
height |
媒体项的原始高度(以像素为单位)。 |
联合字段 metadata 。媒体内容所代表的底层媒体类型的专属元数据。metadata 只能是下列其中一项: |
|
photo |
照片媒体类型的元数据。 |
video |
视频媒体类型的元数据。 |
照片
照片的专属元数据,例如 ISO、焦距和曝光时间。其中部分字段可能为 null 或未包含在内。
JSON 表示法 |
---|
{ "cameraMake": string, "cameraModel": string, "focalLength": number, "apertureFNumber": number, "isoEquivalent": integer, "exposureTime": string } |
字段 | |
---|---|
cameraMake |
拍照所用相机的品牌。 |
cameraModel |
拍照所用相机的型号。 |
focalLength |
拍照所用相机镜头的焦距。 |
apertureFNumber |
拍照所用相机镜头的光圈 (f) 数。 |
isoEquivalent |
拍照所用相机的 ISO。 |
exposureTime |
拍照时相机光圈的曝光时间。 此时长以秒为单位,最多包含九个小数位,以“ |
视频
视频的特定元数据,例如 fps 和处理状态。其中部分字段可能为 null 或未包含在内。
JSON 表示法 |
---|
{
"cameraMake": string,
"cameraModel": string,
"fps": number,
"status": enum ( |
字段 | |
---|---|
cameraMake |
拍摄视频所用相机的品牌。 |
cameraModel |
拍摄视频所用相机的型号。 |
fps |
视频的帧速率。 |
status |
视频的处理状态。 |
VideoProcessingStatus
上传到 Google 相册的视频的处理状态。
枚举 | |
---|---|
UNSPECIFIED |
视频处理状态未知。 |
PROCESSING |
视频正在处理中。用户在 Google 相册应用中看到此视频的图标,但视频尚不能播放。 |
READY |
视频处理完毕,现在可以观看了。重要提示:尝试下载未处于就绪状态的视频可能会失败。 |
FAILED |
出了点问题,无法处理该视频。 |
ContributorInfo
添加媒体项的用户的相关信息。请注意,仅当媒体内容位于应用创建的共享影集内且您拥有共享范围时,此信息才会显示。
JSON 表示法 |
---|
{ "profilePictureBaseUrl": string, "displayName": string } |
字段 | |
---|---|
profilePictureBaseUrl |
指向贡献者个人资料照片的网址。 |
displayName |
创作贡献者的显示名。 |
方法 |
|
---|---|
|
在用户的 Google 相册媒体库中创建一项或多项媒体内容。 |
|
返回拥有指定媒体内容标识符的媒体内容列表。 |
|
返回具有指定媒体内容标识符的媒体内容。 |
|
列出用户 Google 相册媒体库中的所有媒体内容。 |
|
使用指定的 id 更新媒体内容。 |
|
搜索用户 Google 相册媒体库中的媒体内容。 |