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 的所有其他參數須與提供網頁權杖的呼叫相符。

要求主體

要求主體必須為空白。

回應主體

提供優惠的回應訊息。

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

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

object (SubscriptionOffer)

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

nextPageToken

string

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

授權範圍

需要下列 OAuth 範圍:

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