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)。如要讀取訂閱項目或應用程式中的所有優惠，可以指定為「-」。如果 productId 指定為「-」，則必須將此參數也指定為「-」。

查詢參數

參數
pageSize

integer

要傳回的訂閱項目數量上限。服務傳回的產品數量可能會少於這個值。如未指定，最多將傳回 50 個訂閱項目。許可的最大值為 1000；超出的數值將一律指定為 1000。
pageToken

string

來自先前 ListSubscriptionsOffers 呼叫的網頁權杖。提供此項目即可擷取後續網頁。

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

要求主體

要求主體必須為空白。

回應主體

offers.list 的回應訊息。

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

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

object (SubscriptionOffer)

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

string

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

授權範圍

需要下列 OAuth 範圍：

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