Method: monetization.onetimeproducts.purchaseOptions.offers.list

特定のアプリ、アイテム、または購入オプションの全特典のリストを作成します。

HTTP リクエスト

GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
packageName

string

必須。特典を読み取る対象の親アプリ(パッケージ名)。

productId

string

必須。特典を読み取る対象の 1 回限りの親アイテム(ID)。アプリのすべての特典を読み取る場合は「-」を指定できます。

purchaseOptionId

string

必須。特典を読み取る対象の親購入オプション(ID)。1 回限りのアイテムまたはアプリのすべての特典を読み取る場合は「-」を指定できます。productId に「-」が指定されている場合は「-」を指定しなければなりません。

クエリ パラメータ

パラメータ
pageSize

integer

省略可。返す特典の最大数。サービスが返す値はこれよりも少ないことがあります。指定されていない場合は、最大で 50 件の特典が返されます。最大値は 1,000 です。1,000 を超える値は 1,000 に強制変換されます。

pageToken

string

省略可。前回の ListOneTimeProductsOffers 呼び出しから受け取ったページトークン。後続のページを取得するにはこれを指定します。

ページネーションを行う場合、ListOneTimeProductsOffersRequest に指定する productId、packageName、purchaseOptionId は、ページトークンを受け取った呼び出しと一致している必要があります。

リクエストの本文

リクエストの本文は空にする必要があります。

レスポンスの本文

offers.list のレスポンス メッセージ。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現
{
  "oneTimeProductOffers": [
    {
      object (OneTimeProductOffer)
    }
  ],
  "nextPageToken": string
}
フィールド
oneTimeProductOffers[]

object (OneTimeProductOffer)

指定されたリクエストの oneTimeProduct 特典。

nextPageToken

string

次のページを取得するために pageToken として送信できるトークン。このフィールドを省略すると、後続のページはなくなります。

認可スコープ

次の OAuth スコープが必要です。

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