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 px（宽）× 1024 px（高）。
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 出了点问题，无法处理该视频。

ContributorInfo

添加媒体项的用户的相关信息。请注意，仅当媒体内容位于应用创建的共享影集内且您拥有共享范围时，此信息才会显示。

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

string

指向贡献者个人资料照片的网址。
displayName

string

创作贡献者的显示名。

方法

batchCreate

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

batchGet

 返回拥有指定媒体内容标识符的媒体内容列表。

get

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

list

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

patch

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