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 相簿應用程式中，使用者可在該項目的資訊部分查看這項資訊。必須少於 1,000 個字元。僅加入使用者撰寫的文字。說明應加入相關背景資訊，並協助使用者瞭解媒體。請勿加入任何自動產生的字串，例如檔案名稱、標記和其他中繼資料。
productUrl

string

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

string

媒體項目位元組的網址。請勿依原樣使用。使用前請先在這個網址後方加上參數。如需完整的支援參數清單，請參閱開發人員說明文件。舉例來說，'=w2048-h1024' 會將相片類型的媒體項目尺寸設為寬度 2048 像素、高度 1024 像素。
mimeType

string

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

object (MediaMetadata)

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

object (ContributorInfo)

加入這個媒體項目的使用者相關資訊。請注意，只有在使用 mediaItems.search 具有共享相簿 ID 時，系統才會納入這項資訊。相簿必須由應用程式建立，且您要設定共用範圍。
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」的時間戳記格式，解析度不超過奈秒，最多 9 個小數位數。範例："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

相機鏡頭的光圈編號。
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

batchGet

get

list

patch

 使用指定的 id 更新媒體項目。