Method: accounts.locations.media.list

傳回與位置相關聯的媒體項目清單。

HTTP 要求

GET https://mybusiness.googleapis.com/v4/{parent=accounts/*/locations/*}/media

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
parent

string

要列出媒體項目的位置名稱。

查詢參數

參數
pageSize

integer

每頁要傳回的媒體項目數量。預設值為 100，這也是可透過 Google My Business API 新增至某個地點的媒體項目數量上限。頁面大小上限為 2500。
pageToken

string

如有指定，系統會傳回媒體項目的下一頁。

要求主體

要求主體必須為空白。

回應主體

如果成功，回應主體即會包含具有以下結構的資料：

Media.ListMediaItems 的回應訊息。

JSON 表示法 
{
  "mediaItems": [
    {
      object (MediaItem)
    }
  ],
  "totalMediaItemCount": integer,
  "nextPageToken": string
}
欄位
mediaItems[]

object (MediaItem)

傳回的媒體項目清單。
totalMediaItemCount

integer

這個位置的媒體項目總數 (與分頁無關)。
nextPageToken

string

如果媒體項目數量超過要求的頁面大小，系統會在這個欄位填入權杖，以便在後續呼叫 media.list 時擷取媒體項目的下一頁。

授權範圍

需要下列其中一種 OAuth 範圍：

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

詳情請參閱 OAuth 2.0 總覽。