傳回與某個位置相關聯的媒體項目清單。
HTTP 要求
GET https://mybusiness.googleapis.com/v4/{parent=accounts/*/locations/*}/media
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
parent |
要列出媒體項目的地區名稱。 |
查詢參數
參數 | |
---|---|
pageSize |
每頁要傳回的媒體項目數量。預設值為 100,等於透過 Google My Business API 可新增至某個地區的媒體項目數量上限。頁面大小上限為 2500。 |
pageToken |
如果有指定,系統會傳回媒體項目的下一頁。 |
要求主體
要求主體必須為空白。
回應主體
如果成功,回應主體會含有以下結構的資料:
Media.ListMediaItems 的回應訊息。
JSON 表示法 | |
---|---|
{
"mediaItems": [
{
object ( |
欄位 | |
---|---|
mediaItems[] |
傳回的媒體項目清單。 |
totalMediaItemCount |
這個位置的媒體項目總數 (無論分頁為何)。 |
nextPageToken |
如果媒體項目的數量超過要求的頁面大小,這個欄位就會填入符記,以便在後續呼叫 media.list 時擷取媒體項目的下一頁。 |
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/plus.business.manage
https://www.googleapis.com/auth/business.manage
詳情請參閱 OAuth 2.0 總覽。