Method: monetization.subscriptions.basePlans.offers.list

列出特定訂閱項目的所有優惠。

HTTP 要求

GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers

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

路徑參數

參數
packageName

string

必要欄位。應讀取訂閱項目的父項應用程式 (套件名稱)。
productId

string

必要欄位。應讀取優惠的父項訂閱項目 (ID)。可以指定為「-」閱讀應用程式提供的所有優惠。
basePlanId

string

必要欄位。應讀取優惠的父項基本方案 (ID)。可以指定為「-」閱讀訂閱項目或應用程式的所有優惠。必須以「-」指定。

查詢參數

參數
pageSize

integer

要傳回的訂閱數量上限。服務傳回的產品數量可能會少於這個值。如未指定，最多將傳回 50 個訂閱項目。值的數量上限是 1000；超過 1000 個值會強制轉換為 1000。
pageToken

string

屬於接收自前一個 ListSubscriptionsOffers 呼叫的網頁權杖。提供此項目即可擷取後續網頁。

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

要求主體

要求主體必須為空白。

回應主體

Offer.list 的回應訊息。

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

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

object (SubscriptionOffer)

指定訂閱項目的訂閱優惠。
nextPageToken

string

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

授權範圍

需要下列 OAuth 範圍：

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