Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazonアプリストア
Ring
AWS
ドキュメント
Support
Contact Us
My Cases
開発
設計と開発
公開
リファレンス
サポート
メインコンテンツへスキップ
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日