記事


App Store サーバー通知の変更履歴


App Store サーバー通知サービスへの変更について説明します。





概観


App Store サーバー通知には 2 つのバージョンの通知があります。バージョン 1 の通知と App Store Server Notifications V1   廃止   エンドポイントは廃止されました。代わりに、バージョン 2 の通知を受信するには、あなたのサーバーに App Store Server Notifications V2 エンドポイントを実装してください。


あなたのサーバーで通知を受信するように設定するには、App Store サーバー通知の有効化 をご覧ください。この変更ログでは、App Store サーバー通知の機能更新、バージョン情報、廃止、削除について説明いたします。



2025 年 3 月 24 日


新機能


  • notificationType に通知型 METADATA_UPDATE と MIGRATE を追加しました。

  • JWSTransactionDecodedPayload に previousOriginalTransactionId フィールドを追加しました。


    • 2025 年 2 月 21 日


    新機能


  • JWSRenewalInfoDecodedPayload と JWSTransactionDecodedPayload を更新し、新しい appTransactionId フィールドと offerPeriod フィールドを追加しました。

  • JWSRenewalInfoDecodedPayload を更新し、appAccountToken フィールドを追加しました。


    • 2025 年 1 月 17 日


    新機能


  • Advanced Commerce API のサポートが追加されました。

    • 2024 年 7 月 8 日


    新機能


  • JWSRenewalInfoDecodedPayload を更新し、新しいフィールド eligibleWinBackOfferIds を追加しました。

  • offerType に再獲得オファーの型を追加しました。


    • 2024 年 6 月 10 日


    新機能


  • notificationType に通知型 ONE_TIME_CHARGE を追加しました。この通知型は現在、サンドボックス環境でのみ利用可能です。

  • JWSRenewalInfoDecodedPayload に、renewalPrice、currency、offerDiscountType の各フィールドを追加しました。


    • 2024 年 4 月 11 日


    新機能


  • data オブジェクトに consumptionRequestReason を追加しました。

  • CONSUMPTION_REQUEST notificationType に、自動更新サブスクリプションの払い戻し要求に関する通知を追加しました。


    • 2024 年 3 月 12 日


    新機能


  • price フィールドの型が int32 から int64 に変更されました。


    • 2024 年 2 月 29 日


    新機能


  • 新しい notificationType EXTERNAL_PURCHASE_TOKEN と subtype UNREPORTED を追加しました。

  • 新しいペイロードオブジェクト externalPurchaseToken を含むように、responseBodyV2DecodedPayload を更新しました。

  • 型 externalPurchaseId と tokenCreationDate を追加しました。


    • 2024 年 1 月 23 日


    新機能


  • 顧客がアクティブでないサブスクリプションのオファーを利用した際に App Store サーバーが送信する通知タイプを SUBSCRIBED notificationType に変更しました。App Store サーバーは、顧客がアクティブなサブスクリプションのオファーを利用した場合にのみ OFFER_REDEEMED 通知の型を送信します。


    • 2023 年 10 月 26 日


    新機能


  • JWSTransactionDecodedPayload オブジェクトに新しいプロパティ (price、currency、offerDiscountType) が追加されました。


    • 2023 年 6 月 5 日


    新機能


  • バージョン 2 の新しい notificationType である REFUND_REVERSED を追加しました。

  • 取引の復号済みペイロード JWSTransactionDecodedPayload に、storefront、storefrontId、transactionReason という新しいフィールドを追加しました。

  • 更新情報の復号済みペイロード JWSRenewalInfoDecodedPayload に renewalDate フィールドを追加しました。

  • responseBodyV2DecodedPayload の data オブジェクトにサブスクリプション status フィールドを追加しました。

  • responseBodyV1   廃止   に 廃止 フィールドが含まれるようになりました。

    • 廃止


  • App Store Server Notifications V1 エンドポイントとバージョン 1 通知は   廃止   となりました。代わりにバージョン 2 通知を受信するには、あなたのサーバーに App Store Server Notifications V2 エンドポイントを実装してください。


    • 2023 年 1 月 30 日


    新機能


  • App Store Server Notifications 2 に、notificationType 値が RENEWAL_EXTENSION、subtype 値が SUMMARY および FAILURE で構成される新しい通知の型を追加しました。この通知は、製品 ID に基づいて、すべてのアクティブな加入者のサブスクリプション更新日を延長した際に情報を提供します。詳しくは、App Store Server API の すべてのアクティブな加入者のサブスクリプション更新日を延長 を参照してください。

  • responseBodyV2DecodedPayload を更新し、新しい summary オブジェクトを追加しました。このオブジェクトは、SUMMARY subtype を持つ RENEWAL_EXTENSION 通知のペイロードに表示されます。


    • 2022 年 11 月 7 日


    新機能


  • EXPIRED notificationType に PRODUCT_NOT_FOR_SALE subtype を追加しました。


    • 2022 年 6 月 6 日


    新機能


  • App Store Server Notifications 2 は、TEST 通知の送信をサポートしています。詳細については、notificationType、および App Store Server API のエンドポイント テスト通知の要求 と テスト通知ステータスの取得 をご覧ください。


    • 2022 年 5 月 12 日


    新機能


  • App Store Server Notifications 2 では、App Store が顧客の同意を必要としない自動更新サブスクリプションの価格値上げを顧客に通知する際に、通知サブタイプ ACCEPTED が送信されるようになりました。この通知サブタイプはバージョン 2 の通知でのみ利用可能です。詳しくは、subtype をご覧ください。


    • 2021 年 10 月 21 日 - バージョン 2


    新機能


  • App Store Server Notifications V2 が利用可能になりました。バージョン 1 も引き続きサポートされています。バージョン 2 で送信される通知の詳細については、notificationType、substate、responseBodyV2 をご覧ください。

  • バージョン 1 で送信される通知の詳細については、notification_type   廃止   と responseBodyV1   廃止  （旧称 responseBody）をご覧ください。

    • 2021 年 3 月 10 日


    廃止


  • App Store Server Notifications バージョン 1   廃止   では、以下の通知の型とトップレベルオブジェクトが廃止され、削除されました：RENEWAL、latest_receipt、latest_receipt_info、latest_expired_receipt、および latest_expired_receipt_info。詳細については、responseBodyV1   廃止   および notification_type   廃止   を参照してください。


    • 2019 年 11 月 21 日 - バージョン 1


    新機能


  • App Store サーバー通知が利用可能になりました。



    • 以下も見よ


    要点


    App Store サーバー通知の有効化

    アプリ内購入イベントと報告されていない外部購入トークンに関する通知を受信するには、あなたのサーバーを構成して HTTPS URL を指定します。


    App Store サーバー通知の受信

    通知投稿を受信して解析するサーバー側コードを実装します。


    App Store サーバー通知への応答

    通知投稿の成功を示す HTTP ステータスコードを送信します。














    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ