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 像素、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 出了点问题，无法处理视频。

ContributorInfo

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

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

string

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

string

贡献者的显示名称。

方法

batchCreate

batchGet

get

list

patch

 使用指定的 id 更新媒体项。