Method: accounts.promotions.list

在 Merchant Center 帳戶中列出促銷活動。回應包含的項目可能少於 pageSize 的指定數量。仰賴 pageToken 判斷是否有更多項目需要提供。

插入或更新促銷活動之後，系統可能需要幾分鐘才能擷取更新後的促銷活動。

HTTP 要求

GET https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*}/promotions

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

路徑參數

參數
parent

string

必要欄位。要列出已處理促銷活動的帳戶。格式：accounts/{account}

查詢參數

參數
pageSize

integer

僅供輸出。要傳回的促銷活動數量上限。服務傳回的產品數量可能會少於這個值。許可的最大值為 1000；超出的數值將一律指定為 1000。如未指定，系統會傳回促銷活動數量上限。
pageToken

string

僅供輸出。屬於接收自前一個 promotions.list 呼叫的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時，提供至 promotions.list 的所有其他參數須與提供網頁權杖的呼叫相符。

要求主體

要求主體必須為空白。

回應主體

promotions.list 方法的回應訊息。

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

JSON 表示法 
{
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "nextPageToken": string
}
欄位
promotions[]

object (Promotion)

指定帳戶的已處理促銷活動。
nextPageToken

string

可做為 pageToken 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 總覽。