REST Resource: accounts.locations.media.customers

資源：MediaItem

單一媒體項目。

JSON 表示法 
{
  "name": string,
  "mediaFormat": enum (MediaFormat),
  "locationAssociation": {
    object (LocationAssociation)
  },
  "googleUrl": string,
  "thumbnailUrl": string,
  "createTime": string,
  "dimensions": {
    object (Dimensions)
  },
  "insights": {
    object (MediaInsights)
  },
  "attribution": {
    object (Attribution)
  },
  "description": string,

  // Union field data can be only one of the following:
  "sourceUrl": string,
  "dataRef": {
    object (MediaItemDataRef)
  }
  // End of list of possible types for union field data.
}
欄位
name

string

此媒體項目的資源名稱。accounts/{accountId}/locations/{locationId}/media/{mediaKey}
mediaFormat

enum (MediaFormat)

此媒體項目的格式。媒體項目建立時必須設定，而且在其他要求中皆為唯讀。設定完成後即無法更新。
locationAssociation

object (LocationAssociation)

呼叫 CreatePhoto 時必須提供。說明這個媒體項目如何連結至其位置。必須是類別 (例如 EXTERIOR) 或價格清單項目的 ID。

透過 media.create 將媒體新增到地點時，此為必要條件。如果是其他類型的媒體 (例如當地貼文中的相片)，系統則不會顯示這類內容。
googleUrl

string

僅供輸出。此媒體項目的 Google 代管網址。這個網址可能會隨時間變動，因此不是靜態網址。影片會顯示重疊的播放圖示的預覽圖片。
thumbnailUrl

string

僅供輸出。此媒體項目的縮圖網址 (如有提供)。
createTime

string (Timestamp format)

僅供輸出。這個媒體項目的建立時間。

RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
dimensions

object (Dimensions)

僅供輸出。尺寸 (寬度和高度)，以像素為單位。
insights

object (MediaInsights)

僅供輸出。這個媒體項目的統計資料。
attribution

object (Attribution)

僅供輸出。客戶媒體項目的歸因資訊。您必須向使用者顯示這個作者資訊，且不得刪除或修改出處。
description

string

這個媒體項目的說明。說明無法透過 Google My Business API 修改，但可在建立不是封面相片的媒體項目時設定。

聯集欄位 data。媒體項目的資料來源。建立新的媒體項目時，必須提供網址或資料參照。

除了 PROFILE 和 COVER 類別以外，所有相片的短邊都必須至少測量出 250 像素，且檔案大小至少為 10240 個位元組。

所有上傳的相片都必須符合商家檔案相片規範。data 只能是下列其中一項：
sourceUrl

string

可從公開存取的網址擷取媒體項目。

建立這個項目或 dataRef 時，必須設為指定媒體項目的來源。

如果在建立媒體項目時使用 sourceUrl，系統就會在擷取媒體項目時填入該來源網址。

無法更新這個欄位。
dataRef

object (MediaItemDataRef)

僅限輸入。透過 media.startUpload 方法取得的媒體項目二進位資料的參照。

建立媒體項目時

sourceUrl

或

dataRef

都必須設定。

方法

get

 傳回所請求客戶媒體項目的中繼資料。

list

 傳回與客戶提供地點相關的媒體項目清單。