REST Resource: mediaItems

資源：PickedMediaItem

代表使用者挑選的相片或影片。

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

string

媒體項目的 ID。

這是一組永久性 ID，可用於在不同工作階段之間，用來識別這個媒體項目。
createTime

string (Timestamp format)

媒體項目的建立時間 (而非上傳至 Google 相簿的時間)。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："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、焦距和曝光時間。部分欄位可能為空值或不包含。

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

number

拍照時相機鏡頭的焦距。
apertureFNumber

number

相機鏡頭的光圈編號。
isoEquivalent

integer

相片拍攝時使用的相機 ISO。
exposureTime

string (Duration format)

相片拍照時，相機光圈的曝光時間。

持續時間以秒為單位，最多 9 個小數位數，結尾為「s」。範例："3.5s"。
printMetadata

object (PrintMetadata)

與列印相片相關的中繼資料。

PrintMetadata

說明相片列印相關屬性的中繼資料，例如列印品質分數。

JSON 表示法 
{
  "qualityScore": enum (Score)
}
欄位
qualityScore

enum (Score)

列印相片的品質分數，用於判斷相片是否適合列印。

請勿利用分數來建議使用者不要列印。如果相片的品質優良，且使用者想要列印該相片，則分數會設為 HIGH。NORMAL 分數表示相片可能不是高品質相片。SCORE_UNSPECIFIED 表示沒有可用的分數。

分數

說明相片列印合適度的分數。

列舉
SCORE_UNSPECIFIED 分數預設為未指定。
HIGH 相片是高分。
NORMAL 相片是正常的分數。

VideoMetadata

影片專屬的中繼資料，例如每秒影格數。

JSON 表示法 
{
  "fps": number
}
欄位
fps

number

影片的畫面更新率。

方法

list

 傳回使用者在指定工作階段中選取的媒體項目清單。