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 像素，且檔案大小至少要有 1,0240 個位元組。

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

string

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

建立此項目或 dataRef 時，必須設定以指定媒體項目的來源。

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

無法更新這個欄位。
dataRef

object (MediaItemDataRef)

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

建立媒體項目時

sourceUrl

或

dataRef

就必須設定。

方法

get

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

list

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