Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazonアプリストア
Ring
AWS
ドキュメント
Support
Contact Us
My Cases
開発
設計と開発
公開
リファレンス
サポート
Skip to main content
Amazonアプリストアの課金フレームワークとやり取りするための主要なAPIを提供します。

コンストラクタ

new PurchasingService()

new PurchasingService(): PurchasingService

戻り値

PurchasingService

メソッド

getProductData()

static getProductData(productDataRequest: IAPTypes.ProductDataRequest): Promise<IAPTypes.ProductDataResponse> 最大100個のSKUのアイテムデータを取得するリクエストを開始します。 使用パターン:
  1. getProductDataは通常、商品ページの起動時に呼び出され、一連のSKUのIAP商品情報(価格など)を取得して表示します。
このプロセスを簡略化するには、このパッケージで提供されているuseIapProductDataフックを利用してください。商品ページコンポーネントでこのフックを呼び出すと、商品ページが起動したときにgetPurchaseUpdates APIが自動的にトリガーされます。
  1. この商品ページのユースケース以外にも、アプリにIAP商品に関連する特定のユースケースがある場合があります。ここで紹介した用途では、このgetProductData APIを利用してください。

パラメーター

productDataRequest
IAPTypes.ProductDataRequest 入力パラメーター。

戻り値

Promise<IAPTypes.ProductDataResponse>
  • 商品データとリクエストのステータスを含むレスポンス。

getPurchaseUpdates()

static getPurchaseUpdates(purchaseUpdatesRequest: IAPTypes.PurchaseUpdatesRequest): Promise<IAPTypes.PurchaseUpdatesResponse> ユーザーが購入またはキャンセルしたアイテムに関するアップデートを取得するリクエストを開始します。 使用パターン:
  1. Amazonでは、購入に関する最新情報を確実に取得するために、アプリのメイン画面を起動するときと、アプリがバックグラウンドからフォアグラウンド(BG-> FG)に移行するときに、getPurchaseUpdates APIを呼び出すことを推奨しています。
このプロセスを簡略化するには、このパッケージで提供されているusePurchaseUpdatesフックを利用してください。メイン画面コンポーネントでこのフックを呼び出すと、メイン画面が起動するとき、またはアプリがBGからFGに移行するときに、getPurchaseUpdates APIが自動的にトリガーされます。
  1. このメイン画面ページのユースケース以外にも、アプリに購入に関連する特定のユースケースがある場合があります。ここで紹介した用途では、このgetPurchaseUpdates APIを利用してください。

パラメーター

purchaseUpdatesRequest
IAPTypes.PurchaseUpdatesRequest 入力パラメーター。

戻り値

Promise<IAPTypes.PurchaseUpdatesResponse>
  • レシートデータとリクエストのステータスを含むレスポンス。

getUserData()

static getUserData(userDataRequest: IAPTypes.UserDataRequest): Promise<IAPTypes.UserDataResponse> 現在ログインしているユーザーのユーザーIDを取得するリクエストを開始します。 使用パターン:
  1. Amazonでは、現在のユーザーアカウントのレシートを確実に取得するために、アプリのメイン画面を起動するときと、アプリがバックグラウンドからフォアグラウンド(BG-> FG)に移行するときに、getUserData APIを呼び出すことを推奨しています。
このプロセスを簡略化するには、このパッケージで提供されているuseUserDataフックを利用してください。メイン画面コンポーネントでこのフックを呼び出すと、メイン画面が起動するとき、またはアプリがBGからFGに移行するときに、getUserData APIが自動的にトリガーされます。
  1. このメイン画面ページのユースケース以外にも、アプリにユーザーIDに関連する特定のユースケースがある場合があります。ここで紹介した用途では、このgetUserData APIを利用してください。

パラメーター

userDataRequest
IAPTypes.UserDataRequest 入力パラメーター。

戻り値

Promise<IAPTypes.UserDataResponse>
  • ユーザーデータとレスポンスコードを含むレスポンス。

modifySubscription()

static modifySubscription(modifySubsRequest: IAPTypes.ModifySubscriptionRequest): Promise<IAPTypes.ModifySubscriptionResponse> 定期購入型アイテムに対するmodifySubscriptionリクエストを開始します。

パラメーター

modifySubsRequest
IAPTypes.ModifySubscriptionRequest 定期購入型アイテムを変更するための入力パラメーター。
  • リクエストのステータス(および成功した場合はレシートデータのリスト)を含むレスポンス。

戻り値

Promise<IAPTypes.ModifySubscriptionResponse>

notifyFulfillment()

static notifyFulfillment(notifyFulfillmentRequest: IAPTypes.NotifyFulfillmentRequest): Promise<IAPTypes.NotifyFulfillmentResponse> 購入アイテムの付与完了についてAmazonに通知します。

パラメーター

notifyFulfillmentRequest
IAPTypes.NotifyFulfillmentRequest 入力パラメーター。

戻り値

Promise<IAPTypes.NotifyFulfillmentResponse>
  • アイテム付与完了の通知リクエストのステータスを含むレスポンス。

purchase()

static purchase(purchaseRequest: IAPTypes.PurchaseRequest): Promise<IAPTypes.PurchaseResponse> 商品の購入フローを開始します。

パラメーター

purchaseRequest
IAPTypes.PurchaseRequest 購入の入力パラメーター。

戻り値

Promise<IAPTypes.PurchaseResponse>
  • レシートデータとリクエストのステータスを含むレスポンス。

requestUserProfileAccess()

static requestUserProfileAccess(): Promise<IAPTypes.UserProfileAccessResponse> ユーザープロフィールへのアクセスのための認可コードを取得するリクエストを開始します。

戻り値

Promise<IAPTypes.UserProfileAccessResponse>
  • ユーザープロフィールへのアクセスのための認可コードとレスポンスコードを含む応答。

最終更新日 2026年10月26日