Type


subtype


バージョン 2 で選択した通知型に関する詳細を提供する文字列。


App Store Server Notifications 2.0+

string subtype




可能な値


ACCEPTED

PRICE_INCREASE notificationType に適用されます。この subtype の通知は、価格の引き上げに顧客の同意が必要な場合は顧客がサブスクリプション価格の引き上げに同意したことを示します。価格の引き上げに顧客の同意が不要な場合は、システムから価格の引き上げが通知されたことを示します。


AUTO_RENEW_DISABLED

DID_CHANGE_RENEWAL_STATUS notificationType に適用されます。この subtype の通知は、ユーザがサブスクリプションの自動更新を無効にしたこと、またはユーザが払い戻しを要求した後に App Store がサブスクリプションの自動更新を無効にしたことを示します。


AUTO_RENEW_ENABLED

DID_CHANGE_RENEWAL_STATUS notificationType に適用されます。この subtype の通知は、ユーザがサブスクリプションの自動更新を有効にしたことを示します。


BILLING_RECOVERY

DID_RENEW notificationType に適用されます。このサブタイプの通知は、以前に更新に失敗した期限切れのサブスクリプションが正常に更新されたことを示します。


BILLING_RETRY

EXPIRED 通知型に適用されます。このサブタイプの通知は、課金再試行期間が終了する前にサブスクリプションの更新に失敗したためにサブスクリプションの有効期限が切れたことを示します。


DOWNGRADE

DID_CHANGE_RENEWAL_PREF および OFFER_REDEEMED notificationType に適用されます。このサブタイプの通知は、ユーザがサブスクリプションをダウングレードしたか、期間の異なるサブスクリプションにクロスグレードしたことを示します。ダウングレードは次回の更新日に有効になります。


FAILURE

RENEWAL_EXTENSION notificationType に適用されます。この subtype の通知は、個々のサブスクリプションのサブスクリプション更新日延長が失敗したことを示します。詳細については、responseBodyV2DecodedPayload 内の data オブジェクトを参照してください。要求の詳細については、すべてのアクティブな購読者のサブスクリプション更新日を延長する (Extend Subscription Renewal Dates for All Active Subscribers) を参照してください。


GRACE_PERIOD

DID_FAIL_TO_RENEW notificationType に適用されます。このサブタイプの通知は、請求の問題によりサブスクリプションの更新に失敗したことを示します。猶予期間中は、引き続きサブスクリプションへのアクセスを提供してください。


INITIAL_BUY

SUBSCRIBED notificationType に適用されます。この subtype の通知は、ユーザが初めてサブスクリプションを購入したか、家族間共有を通じて初めてサブスクリプションへのアクセスを取得したことを示します。


PENDING

PRICE_INCREASE notificationType に適用されます。この subtype の通知は、システムがユーザにサブスクリプション購入価格の値上げを通知したが、ユーザがまだそれを承認していないことを示します。


PRICE_INCREASE

EXPIRED notificationType に適用されます。この subtype の通知は、ユーザが価格の値上げに同意しなかったためにサブスクリプションの有効期限が切れたことを示します。


PRODUCT_NOT_FOR_SALE

EXPIRED notificationType に適用されます。この subtype の通知は、サブスクリプションの更新を試みたときに製品が購入できなかったため、サブスクリプションが期限切れになったことを示します。


RESUBSCRIBE

SUBSCRIBED notificationType に適用されます。この subtype の通知は、ユーザが同じサブスクリプションまたは同じサブスクリプショングループ内の別のサブスクリプションに再登録したか、家族間共有を通じてアクセス権を取得したことを示します。


SUMMARY

RENEWAL_EXTENSION notificationType に適用されます。このサブタイプの通知は、App Store サーバが、対象となるすべての加入者のサブスクリプション更新日を延長する要求を完了したことを示します。概要の詳細については、responseBodyV2DecodedPayload 内の summary オブジェクトを参照してください。要求の詳細については、すべてのアクティブな購読者のサブスクリプション更新日を延長する (Extend Subscription Renewal Dates for All Active Subscribers) を参照してください。


UPGRADE

DID_CHANGE_RENEWAL_PREF および OFFER_REDEEMED notificationType に適用されます。この subtype の通知は、ユーザがサブスクリプションをアップグレードしたか、同じ期間のサブスクリプションにクロスグレードしたことを示します。アップグレードは直ちに有効になります。


UNREPORTED

EXTERNAL_PURCHASE_TOKEN notificationType に適用されます。この subtype の通知は、Apple があなたのアプリのトークンを作成したが、レポートを受け取っていないことを示します。トークンのレポートの詳細については、externalPurchaseToken を参照してください。


VOLUNTARY

EXPIRED notificationType に適用されます。このサブタイプの通知は、ユーザがサブスクリプションの自動更新を無効にした後にサブスクリプションの有効期限が切れたことを示します。



以下にて言及


App Store サーバー通知の変更履歴 (App Store Server Notifications changelog)



議論


この subtype フィールドは responseBodyV2DecodedPayload の一部であり、notificationType 型のイベントの詳細を説明します。これは特定のバージョン 2 の通知にのみ存在します。





以下も見よ


サーバ通知バージョン 2


App Store Server Notifications V2

バージョン 2 の通知を受信するには、App Store Connect で安全なサーバの URL を指定します。


object responseBodyV2

App Store がバージョン 2 サーバ通知で送信する応答本文。


object responseBodyV2DecodedPayload

バージョン 2 通知データを含む復号されたペイロード。


type notificationType

App Store がバージョン 2 通知を送信するアプリ内購入または外部購入イベントを記述する型。


type subtype

バージョン 2 で選択した通知型に関する詳細を提供する文字列。














トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ