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 相册应用的媒体内容信息部分看见此内容。长度不得超过 1,000 个字符。仅包含用户撰写的文本。说明应提供背景信息，帮助用户了解媒体内容。请勿添加任何自动生成的字符串，例如文件名、标记和其他元数据。
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 相册的时间）。

采用 RFC 3339 标准，生成的输出将始终在末尾带 Z，并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
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 相册媒体库中由应用创建的媒体内容。