アプリ内課金（IAP）の概要 - Amazon Vega Docs

Amazon Developer

Console

as

Settings

Sign out

Notifications

Alexa

Amazonアプリストア

Ring

AWS

ドキュメント

Support

Contact Us

My Cases

Console

as

Vega開発者向けドキュメント

開発

設計と開発

公開

リファレンス

サポート

アプリ内課金（IAP）APIを使用すると、デジタルコンテンツや定期購入型アイテムの表示、処理、アイテム付与をアプリ内で行うことができます。AmazonはVegaアプリ用のIAP APIをサポートしています。このページでは、IAP APIとプレビューリリースで利用できる機能を大まかに紹介します。アップグレード方法の詳細については、以下の手順を参照してください。

アプリ内課金（IAP）とは

IAPを使用すると、アプリのユーザーがさまざまな種類のデジタルアイテムをアプリ内で購入できるようになります。これには、ゲームの追加ライフや定期購入型のプレミアムコンテンツといったアイテムが含まれます。 IAPのユースケースとしては、次のようなものが考えられます。

アプリ自体は無料としながら、高度なサービスや機能を有料とする「フリーミアム」モデルを作成する。
ゲーム体験を充実させるために、通貨、追加アクション、ライフなどのアイテムをユーザーが購入できるようにする。
ユーザーがコンテンツへのアクセス権限を購入したら、ボーナスステージやミニゲームの利用制限を解除（アンロック）する。
アプリ内で提供されるコンテンツをユーザーが定期購入できるようにする。

購入フロー、支払い処理、アプリのレシート、購入可能なコンテンツの権限の管理に関する詳細な処理は、IAP APIによって行われます。このような処理を行うコードを独自に作成する必要はありません。

アプリに必要なパッケージの依存関係を追加する

package.jsonファイルに、@amazon-devices/keplerscript-appstore-iap-libパッケージを依存関係として追加します。

{
  "dependencies": {
    "@amazon-devices/keplerscript-appstore-iap-lib": "~2.13.0",
  }
},

Fire OSとVegaのIAPメソッドの比較

API	説明	Fire OSのオブジェクト（Java）	Vegaのオブジェクト（JS）	VegaとFire OSの違い	Keplerでの相違点
`getUserData`	現在ログインしているユーザーのユーザーIDを取得するリクエストを開始します。	`UserDataRequest` `UserDataResponse`	`UserDataRequest` `UserDataResponse`	なし	該当なし
`getProductData`	最大100個のSKUのアイテムデータを取得するリクエストを開始します。	`getProductData` API呼び出しの一部として、SKUのリストを送信します。`ProductDataResponse`によりレスポンスが返されます。	`ProductDataRequest` `ProductDataResponse`	あり	1.価格はFire OSでは文字列ですが、Vegaでは、`currencyFormattedPrice`、`currencyCode`、`promotionPrice`、マイクロ単位の`priceValue`を含むオブジェクトです。 2.`promotionPlans`オブジェクト内の`Promotion`フィールドは、Vegaでは`plans`に変更されています。 3. `promotionPrice`、`promotionPriceCycles`、`promotionPricePeriod`は、`price`、`priceCycles`、`period`に変更されています。
`purchase`	商品の購入フローを開始します。	Purchase API呼び出しの一部として、単一のSKUを送信します。`PurchaseResponse`によりレスポンスが返されます。	`PurchaseRequest` `PurchaseResponse`	なし	該当なし
`getPurchaseUpdates`	ユーザーが購入またはキャンセルしたアイテムに関する更新情報を取得するリクエストを開始します。この表の後にある「デバイスキャッシュに関する注意事項」を参照してください。	getPurchaseUpdates API呼び出しの一部として、リセットフラグを送信します。`PurchaseUpdatesResponse`によりレスポンスが返されます。	`PurchaseUpdatesRequest` `PurchaseUpdatesResponse`	なし	該当なし
`modifySubscription`	定期購入型アイテムに対する`modifySubscription`リクエストを開始します。	modifySubscription API呼び出しにSKUと比例配分モードを送信します。`ModifySubscriptionResponse`によりレスポンスが返されます。	`ModifySubscriptionRequest` `ModifySubscriptionResponse`	なし	該当なし
`notifyFulfillment`	購入アイテムの付与完了についてAmazonに通知します。	リクエストで`receiptId`と`FulfillmentResult`を送信します。レスポンスは送信されません。これはvoid呼び出しです。	`NotifyFulfillmentRequest`	あり	`NotifyFulfillmentResponseCode`が送信されます。

Fire OS用のIAPとVega用のIAP

Fire OSでは、IAP SDKはJavaで記述されたAndroidアプリで動作します。Vegaでは、IAP APIはVega SDKと統合され、JavaScriptで記述されます。AmazonアプリストアにIAPアイテムを申請すると、ライブアプリテストなどの本番環境のAPIを実装できます。次の表は、Vegaが現在サポートしているIAPコンポーネントの一覧です。

IAPコンポーネント	説明	テクニカルドキュメント
IAP API	アプリ内購入の実行と処理に使用されるAPI	IAP API の概要
App Tester	アプリをローカルでテストするためのツール	App Testerをインストールして構成する方法
レシート検証サービス（RVS）Cloud Sandbox	サンドボックスモードでトランザクションのレシートの有効性を検証	アプリ内課金（IAP）アプリのレシート検証

最終更新日 2026年10月26日