資源:MediaItem
代表 Google 相簿中的媒體項目 (例如相片或影片)。
JSON 表示法 |
---|
{ "id": string, "description": string, "productUrl": string, "baseUrl": string, "mimeType": string, "mediaMetadata": { object ( |
欄位 | |
---|---|
id |
媒體項目的 ID。這是一個永久性 ID,可在各工作階段之間用來識別這個媒體項目。 |
description |
媒體項目的說明。系統會在 Google 相簿應用程式的項目資訊專區中向使用者顯示這則評論 (長度必須少於 1000 個半形字元)。只加入使用者撰寫的文字。說明應提供背景資訊,並協助使用者瞭解媒體內容。請勿加入任何自動產生的字串,例如檔案名稱、標記和其他中繼資料。 |
productUrl |
媒體項目的 Google 相簿網址。使用者必須登入帳戶,才能使用這個連結。從相簿搜尋結果擷取內容時,網址會指向相簿中的項目。 |
baseUrl |
媒體項目位元組的網址。這個值不應依原樣使用。使用參數前,必須先為這個網址附加參數。如需支援參數的完整清單,請參閱開發人員說明文件。舉例來說, |
mimeType |
媒體項目的 MIME 類型。例如 |
mediaMetadata |
與媒體項目相關的中繼資料,例如高度、寬度或建立時間。 |
contributorInfo |
新增此媒體項目的使用者相關資訊。請注意,只有在使用具有共享相簿 ID 的 |
filename |
媒體項目的檔案名稱。使用者會在 Google 相簿應用程式中的項目資訊部分看到這個名稱。 |
MediaMetadata
媒體項目的中繼資料。
JSON 表示法 |
---|
{ "creationTime": string, "width": string, "height": string, // Union field |
欄位 | |
---|---|
creationTime |
首次建立媒體項目的時間 (而非上傳到 Google 相簿的時間)。 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
width |
媒體項目的原始寬度 (以像素為單位)。 |
height |
媒體項目的原始高度 (以像素為單位)。 |
聯集欄位 metadata 。媒體項目所代表基礎媒體類型的中繼資料。metadata 只能是下列其中一項: |
|
photo |
相片媒體類型的中繼資料。 |
video |
影片媒體類型的中繼資料。 |
相片
相片專用的中繼資料,例如 ISO、焦距和曝光時間。部分欄位可能為空值或不包含。
JSON 表示法 |
---|
{ "cameraMake": string, "cameraModel": string, "focalLength": number, "apertureFNumber": number, "isoEquivalent": integer, "exposureTime": string } |
欄位 | |
---|---|
cameraMake |
拍照時拍攝的相機品牌。 |
cameraModel |
用於拍攝相片的相機型號。 |
focalLength |
相片拍攝的相機鏡頭焦距。 |
apertureFNumber |
用於拍攝相片的相機鏡頭光圈 F。 |
isoEquivalent |
拍照使用的相機 ISO。 |
exposureTime |
相片拍攝時的相機光圈曝光時間。 時間長度以秒為單位,最多可有 9 個小數位數,並結尾為「 |
影片
影片專屬的中繼資料,例如每秒影格數和處理狀態。部分欄位可能為空值或不包含。
JSON 表示法 |
---|
{
"cameraMake": string,
"cameraModel": string,
"fps": number,
"status": enum ( |
欄位 | |
---|---|
cameraMake |
拍攝影片的攝影機品牌。 |
cameraModel |
影片拍攝時使用的相機型號。 |
fps |
影片的影格速率。 |
status |
影片的處理狀態。 |
VideoProcessingStatus
影片上傳至 Google 相簿的處理狀態。
列舉 | |
---|---|
UNSPECIFIED |
影片處理狀態不明。 |
PROCESSING |
影片正在處理中。使用者在 Google 相簿應用程式中看到這部影片的圖示,但該圖示還無法播放。 |
READY |
影片處理完畢,已可供觀看。重要事項:嘗試下載未處於「就緒」狀態的影片可能會失敗。 |
FAILED |
發生錯誤,無法處理影片。 |
ContributorInfo
新增媒體項目的使用者相關資訊。請注意,只有當媒體項目位於應用程式建立的共享相簿中,而且您已設定共用範圍時,系統才會納入這項資訊。
JSON 表示法 |
---|
{ "profilePictureBaseUrl": string, "displayName": string } |
欄位 | |
---|---|
profilePictureBaseUrl |
貢獻者個人資料相片的網址。 |
displayName |
協作者的顯示名稱。 |
方法 |
|
---|---|
|
在使用者的 Google 相簿相片庫中建立一或多個媒體項目。 |
|
傳回指定媒體項目 ID 的媒體項目清單。 |
|
傳回指定媒體項目 ID 的媒體項目。 |
|
列出使用者 Google 相簿相片庫中的所有媒體項目。 |
|
將媒體項目更新為指定的 id 。 |
|
搜尋使用者 Google 相簿相片庫中的媒體項目。 |