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

媒体项的 Google 相册网址。用户只有在登录后才能访问此链接。通过影集搜索检索到的网址会指向影集中的内容。

baseUrl

string

媒体项字节的网址。不应按原样使用该参数。参数应在使用前附加到此网址。如需查看受支持参数的完整列表,请参阅开发者文档。例如,'=w2048-h1024' 会将照片类型的媒体项的尺寸设置为 2048 像素(宽)x 1024 像素(高)。

mimeType

string

媒体项的 MIME 类型。例如 image/jpeg

mediaMetadata

object (MediaMetadata)

与媒体项相关的元数据,例如高度、宽度或创建时间。

contributorInfo

object (ContributorInfo)

添加了此媒体项的用户的相关信息。请注意,仅当将 mediaItems.search 与共享影集的 ID 一起使用时,系统才会添加此信息。影集必须由您的应用创建,而且您拥有共享范围。

filename

string

媒体项的文件名。此信息会在 Google 相册应用的内容部分向用户显示。

MediaMetadata

媒体项的元数据。

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)(即“祖鲁时”)格式,分辨率为纳秒,最多包含九个小数位。示例:"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、焦距和曝光时间。其中一些字段可能为 null 或不包含。

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"

视频广告系列

视频特有的元数据,例如 fps 和处理状态。其中一些字段可能为 null 或不包含。

JSON 表示法
{
  "cameraMake": string,
  "cameraModel": string,
  "fps": number,
  "status": enum (VideoProcessingStatus)
}
字段
cameraMake

string

拍摄视频时所用的相机的品牌。

cameraModel

string

拍摄视频时所用的相机型号。

fps

number

视频的帧速率。

status

enum (VideoProcessingStatus)

视频的处理状态。

VideoProcessingStatus

上传到 Google 相册的视频的处理状态。

枚举
UNSPECIFIED 视频处理状态未知。
PROCESSING 正在处理视频。用户会在 Google 相册应用中看到此视频的图标,但目前无法播放。
READY 视频处理已完成,可以立即观看了。重要提示:尝试下载未处于“就绪”状态的视频可能会失败。
FAILED 出错了,无法处理视频。

贡献者信息

添加了媒体项的用户的相关信息。请注意,仅当此媒体项位于您的应用创建的共享影集中且您拥有共享范围时,此信息才会包含在内。

JSON 表示法
{
  "profilePictureBaseUrl": string,
  "displayName": string
}
字段
profilePictureBaseUrl

string

创作贡献者个人资料的网址。

displayName

string

贡献者的显示名。

方法

batchCreate

在用户的 Google 相册媒体库中创建一个或多个媒体内容。

batchGet

返回具有指定媒体项标识符的媒体项列表。

get

返回具有指定媒体项标识符的媒体项。

list

列出用户 Google 相册媒体库中的所有媒体内容。

patch

使用指定的 id 更新媒体项。
搜索用户 Google 相册媒体库中的媒体内容。