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 相簿的時間)。

使用 RFC 3339，產生的輸出內容一律會經過 Z 規格化，並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
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 相簿相片庫中搜尋應用程式建立的媒體項目。