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 更新媒體項目。