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 像素、高度 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

拍攝相片的相機鏡頭光圈 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 相簿相片庫中的媒體項目。