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」格式的時間戳記，精確度達奈秒單位，最多九個小數位數。例如 "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

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