PurchasingService

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が自動的にトリガーされます。

2) この商品ページのユースケース以外にも、アプリに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が自動的にトリガーされます。

2) お使いのアプリには、このメイン画面ページのユースケース以外にも、購入に関連する特別なユースケースもあるでしょう。ここで紹介した用途では、この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が自動的にトリガーされます。

2) お使いのアプリには、このメイン画面ページのユースケース以外にも、ユーザー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>

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

---

Last updated: 2026年7月22日