Web Service


Advanced Commerce API (高度な商業 API)


App Store を通じてアプリ内購入をサポートし、カスタムの 1 回限りの購入、サブスクリプション、オプションのアドオンを含むサブスクリプションの非常に大規模なカタログを提供します。





概観


このフレームワークを使用すると、App Store の商業システムを使用しながら、1 回限りの購入、サブスクリプション、およびオプションのアドオンを含むサブスクリプションの非常に大規模なカタログを提供できます。この API を使用するアプリは、独自のアプリ内購入 、SKU カタログをホストして管理します。App Store 商業システムは、エンドツーエンドの支払い処理、グローバル配信、税金サポート、およびカスタマーサービスを処理します。


Advanced Commerce API と StoreKit アプリ内購入 API を同じアプリで使用できます。アプリ内購入 API を使用する場合は、すべての製品 ID を事前に構成して下さい。Advanced Commerce API を使用する場合は、独自の SKU カタログをホストして管理し、実行時に製品の詳細を動的に指定します。完全な設定情報については、Advanced Commerce API 用にプロジェクトを設定する を参照してください。


高度な商業 API 機能は、あなたのアプリで StoreKit を使用して行う要求と、あなたのサーバからのエンドポイント要求を通じて利用できます。これらの要求を承認するには、JSON Web トークン (JWTs) を生成します。App Store サーバライブラリには、呼び出しを承認するための JWT を簡単に作成できるクライアントが用意されています。ライブラリの詳細については、App Store サーバー ライブラリを使用して実装を簡素化する を参照してください。呼び出しの承認の詳細については、あなたのサーバからの API 要求の承認 (Authorizing API requests from your server) を参照してください。


Advanced Commerce API を呼び出すには、あなたのサーバーは Transport Layer Security (TLS) プロトコル 1.2 以降をサポートしていなければなりません。


重要

資格の詳細と Advanced Commerce API へのアクセスの適応については、Advanced Commerce API を参照してください。




トピックス


要点


Advanced Commerce API 用にプロジェクトを設定する

App Store Connect であなたのアプリを構成し、サーバをセットアップして、SKU を準備します。


あなたのアプリ内購入用の SKU を作成する

あなたのアプリ内で、1 回限りの料金、サブスクリプション、バンドルサブスクリプションを定義および管理します。


サブスクリプションを管理するためのリンクを設定する

あなたのアプリのサブスクリプション管理ページへのディープリンクを作成します。


Advanced Commerce API の変更履歴

Advanced Commerce API の新機能と更新について学びます。



税コードと価格


Advanced Cmmerce SKU の価格指定

SKU の価格を、サポートされている小数点以下の桁数(通貨のミリ単位)で提供します。


あなたの SKU の税コードの選択

アプリ内購入としてあなたのアプリが提供する製品を表す各 SKU の税コードを選択します。


サブスクリプション価格の変更への対応

価格変更を開始する前に、顧客に通知し、該当する同意を得るために必要な連絡を行ってください。



API 認証とレート制限


あなたのサーバーからの API 要求の承認

あなたのサーバーからの Advanced Commerce 要求を承認するための JSON Web Token(JWT)を作成します。


Advanced Commerce API のレート制限の特定

Advanced Commerce API エンドポイントに適用されるレート制限を認識し、対処します。



アプリ内 API 要求


あなたのアプリから高度な商業 API 要求を送信する

あなたのサーバ上で生成した JSON Web 署名 (JWS) を使用して承認した Advanced Commerce API (高度な商業 API) 要求をあなたのアプリから送信します。


App Store の要求に署名するための JWS の生成

あなたのアプリ内の API 要求を承認するために、あなたのサーバ上に署名済みの JSON Web 署名 (JWS) 文字列を作成します。



アプリ内での 1 回限りの請求の作成


object OneTimeChargeCreateRequest

顧客が 1 回限りの課金商品を購入したときにあなたのアプリが提供する要求データ。


object OneTimeChargeItem

表示名、価格、SKU、メタデータなど、1 回限りの課金商品の詳細。



アプリ内でのサブスクリプション作成


object SubscriptionCreateRequest

顧客が自動更新サブスクリプションを購入したときにあなたのアプリが提供する要求データ。


object SubscriptionCreateItem

サブスクリプションアイテムを説明するデータ。



アプリ内でのサブスクリプションの変更


object SubscriptionModifyInAppRequest

自動更新サブスクリプションに変更を加えるためにあなたのアプリが提供する要求データ。


object SubscriptionModifyAddItem

自動更新サブスクリプションに変更を加えるときに、あなたのアプリがアイテムを追加するために提供するデータ。


object SubscriptionModifyChangeItem

自動更新サブスクリプションのアイテムを変更するためにあなたのアプリが提供するデータ。


object SubscriptionModifyRemoveItem

自動更新サブスクリプションからアイテムを削除するためにあなたのアプリが提供するデータ。


object SubscriptionModifyPeriodChange

自動更新サブスクリプションの期間を変更するためにあなたのアプリが提供するデータ。



アプリ内でのサブスクリプションの再有効化


object SubscriptionReactivateInAppRequest

自動更新がオフになっているサブスクリプションを再度活性化するためにあなたのアプリが提供する要求。


object SubscriptionReactivateItem

サブスクリプション内で再有効化すべきアイテム。















トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ