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 總覽