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,
  "filename": string,
  "mediaFileMetadata": {
    object (MediaFileMetadata)
  }
}
欄位
baseUrl

string

用於擷取媒體檔案位元組的網址。

如要下載媒體檔案,API 用戶端必須將開發人員說明文件中指定的參數加到這個網址

例如,'=w2048-h1024' 會將相片類型媒體項目的寬度和高度分別設為 2048 像素和 1024 像素。

mimeType

string

媒體檔案的 MIME 類型。例如 image/jpeg

filename

string

媒體檔案的檔案名稱。

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
}
欄位
focalLength

number

拍攝相片的相機鏡頭焦距。

apertureFNumber

number

拍攝相片的相機鏡頭光圈 f 值。

isoEquivalent

integer

拍攝相片的相機 ISO。

exposureTime

string (Duration format)

拍攝相片時,相機光圈的曝光時間。

時間長度以秒為單位,最多可有 9 個小數位數,並應以「s」結尾,例如:"3.5s"

VideoMetadata

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

JSON 表示法
{
  "fps": number,
  "processingStatus": enum (VideoProcessingStatus)
}
欄位
fps

number

影片的畫面更新率。

processingStatus

enum (VideoProcessingStatus)

影片的處理狀態。

VideoProcessingStatus

儲存在 Google 相簿中的影片處理狀態。

列舉
UNSPECIFIED 未指定影片處理狀態。
PROCESSING

系統正在處理影片。

使用者會在 Google 相簿應用程式中看到這部影片的圖示,但無法播放。

READY

影片處理作業已完成,現在可以觀看這部影片了。

嘗試下載未處於 READY 狀態的影片可能會失敗。

FAILED 發生錯誤,無法處理影片。

方法

list

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