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

媒體項目的 ID。這是一個永久性 ID，可在各工作階段之間用來識別這個媒體項目。
description

string

媒體項目的說明。系統會在 Google 相簿應用程式的項目資訊專區中向使用者顯示這則評論 (長度必須少於 1000 個半形字元)。只加入使用者撰寫的文字。說明應提供背景資訊，並協助使用者瞭解媒體內容。請勿加入任何自動產生的字串，例如檔案名稱、標記和其他中繼資料。
productUrl

string

媒體項目的 Google 相簿網址。使用者必須登入帳戶，才能使用這個連結。從相簿搜尋結果擷取內容時，網址會指向相簿中的項目。
baseUrl

string

媒體項目位元組的網址。這個值不應依原樣使用。使用參數前，必須先為這個網址附加參數。如需支援參數的完整清單，請參閱開發人員說明文件。舉例來說，'=w2048-h1024' 會將媒體項目的尺寸設為 2048 px，高度為 1024 像素。
mimeType

string

媒體項目的 MIME 類型。例如 image/jpeg。
mediaMetadata

object (MediaMetadata)

與媒體項目相關的中繼資料，例如高度、寬度或建立時間。
contributorInfo

object (ContributorInfo)

新增此媒體項目的使用者相關資訊。請注意，只有在使用具有共享相簿 ID 的 mediaItems.search 時，才會加入此元素。相簿必須由應用程式建立，且你必須設定分享範圍。
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 相簿的時間)。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度和最多九個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
width

string (int64 format)

媒體項目的原始寬度 (以像素為單位)。
height

string (int64 format)

媒體項目的原始高度 (以像素為單位)。
聯集欄位 metadata。媒體項目所代表基礎媒體類型的中繼資料。metadata 只能是下列其中一項：
photo

object (Photo)

相片媒體類型的中繼資料。
video

object (Video)

影片媒體類型的中繼資料。

相片

相片專用的中繼資料，例如 ISO、焦距和曝光時間。部分欄位可能為空值或不包含。

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)

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

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

影片

影片專屬的中繼資料，例如每秒影格數和處理狀態。部分欄位可能為空值或不包含。

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

 傳回指定媒體項目 ID 的媒體項目清單。

get

 傳回指定媒體項目 ID 的媒體項目。

list

 列出使用者 Google 相簿相片庫中的所有媒體項目。

patch

 將媒體項目更新為指定的 id。
搜尋使用者 Google 相簿相片庫中的媒體項目。