REST Resource: mediaItems

资源：PickedMediaItem

表示用户选择的照片或视频。

JSON 表示法 
{
  "id": string,
  "createTime": string,
  "type": enum (Type),
  "mediaFile": {
    object (MediaFile)
  }
}
字段
id

string

媒体项的标识符。

这是一个永久标识符，可用于在会话之间标识此媒体项。
createTime

string (Timestamp format)

媒体内容的创建时间（不是上传到 Google 相册的时间）。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
type

enum (Type)

此媒体项的类型。
mediaFile

object (MediaFile)

构成此媒体文件的媒体文件。

类型

媒体项的类型。

枚举
TYPE_UNSPECIFIED 默认情况下，未指定类型。
PHOTO 媒体项表示静态图片。
VIDEO 媒体项表示视频。

MediaFile

表示单个媒体字节文件。

JSON 表示法 
{
  "baseUrl": string,
  "mimeType": string,
  "mediaFileMetadata": {
    object (MediaFileMetadata)
  }
}
字段
baseUrl

string

指向媒体文件字节的网址。

要下载媒体文件，API 客户端必须将 开发者文档中指定的参数添加到此网址中。

例如，'=w2048-h1024' 会将照片类型的媒体内容的尺寸设置为 2048 像素、1024 像素。
mimeType

string

媒体文件的 MIME 类型。例如 image/jpeg。
mediaFileMetadata

object (MediaFileMetadata)

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

MediaFileMetadata

有关媒体文件的元数据。

JSON 表示法 
{
  "width": integer,
  "height": integer,
  "cameraMake": string,
  "cameraModel": string,

  // Union field metadata can be only one of the following:
  "photoMetadata": {
    object (PhotoMetadata)
  },
  "videoMetadata": {
    object (VideoMetadata)
  }
  // End of list of possible types for union field metadata.
}
字段
width

integer

媒体文件的原始宽度（以像素为单位）。
height

integer

媒体文件的原始高度（以像素为单位）。
cameraMake

string

拍照所用相机的品牌。
cameraModel

string

拍照所用相机的型号。
联合字段 metadata。媒体文件所代表的底层媒体类型的特定元数据。metadata 只能是下列其中一项：
photoMetadata

object (PhotoMetadata)

照片媒体类型的元数据。
videoMetadata

object (VideoMetadata)

视频媒体类型的元数据。

PhotoMetadata

照片特有的元数据，例如 ISO、焦距和曝光时间。其中一些字段可能为 null 或未包含在内。

JSON 表示法 
{
  "focalLength": number,
  "apertureFNumber": number,
  "isoEquivalent": integer,
  "exposureTime": string,
  "printMetadata": {
    object (PrintMetadata)
  }
}
字段
focalLength

number

拍照所用相机镜头的焦距。
apertureFNumber

number

拍照所用相机镜头的光圈 f 号。
isoEquivalent

integer

拍照所用相机的 ISO。
exposureTime

string (Duration format)

拍照时相机光圈的曝光时间。

该时长以秒为单位，最多包含九个小数位，以“s”结尾。示例："3.5s"。
printMetadata

object (PrintMetadata)

与照片打印相关的元数据。

PrintMetadata

描述照片的打印相关属性的元数据，例如打印质量得分。

JSON 表示法 
{
  "qualityScore": enum (Score)
}
字段
qualityScore

enum (Score)

照片的打印质量得分，用于确定照片是否适合打印。

该得分不得用于建议用户不要打印。如果照片具有较高的画质，并且用户可能想要打印，则得分会设为 HIGH。NORMAL 分表示照片质量不佳。SCORE_UNSPECIFIED 表示没有可用的得分。

得分

描述照片适合打印的分数。

枚举
SCORE_UNSPECIFIED 默认情况下，得分未指定。
HIGH 这张照片打出高分。
NORMAL 此照片为正常分数。

VideoMetadata

视频特有的元数据，例如 fps。

JSON 表示法 
{
  "fps": number
}
字段
fps

number

视频的帧速率。

方法

list

 返回用户在指定会话期间选择的媒体内容列表。