App Store Connect Group Purchasesのサンドボックス検証方法:2026年ガイド

2026年11月からSandbox Apple AccountでGroup Purchasesを設定・テストできるとAppleは案内しています。したがって、今はStoreKit 2とアプリ側の席・権限ロジックを準備し、実際の購入と招待の検証はサンドボックス機能の公開後に行ってください。単独のサブスクリプション購入が通っても、複数席の受け入れ完了とは判断できません。(Appleの告知)

この内容は、StoreKit 2に複数席のサブスクリプションを組み込みたいiOS開発者向けです。App Store Connectの設定を確認する担当者や、Xcode CIに再現可能な検証記録を残したいCIエンジニアにも役立ちます。

最終更新:2026年10月31日。公開状況はApple Developerの告知、実装範囲はWWDC26の公式Group Purchasesセッションを基に確認しています。開始日や操作の詳細は、Appleの更新に合わせて再確認してください。

01 サンドボックス公開前にStoreKit 2の基準をそろえる

AppleはGroup Purchasesを、StoreKit 2を使う自動更新サブスクリプション向けの機能として説明しています。まず既存の単独購入処理を基準にし、取引の検証、アプリ内の権限付与、更新時の状態反映がどこで行われるかを把握してください。(WWDC26の公式説明)

購入者、招待されたメンバー、席数、アプリ内の権限は別々の状態として扱います。Appleがサブスクリプションの取引情報を提供しても、アプリ固有のチーム構成や業務権限まで自動的に決めるとは限りません。サーバー側のユーザーIDとApple側の取引・グループ情報を、どの規則で結び付けるかを事前に定義しましょう。

検証対象 先に記録すること 受け入れ時に照合すること
購入者 既存の購入要求と取引検証の流れ 購入後の席の状態と購入者自身の権限
招待メンバー アプリ内のユーザー識別方法 招待受諾後の所属、席の状態、権限
席数 アプリ側で保持する席数と更新箇所 購入内容と割り当て済みメンバーの整合性
サーバー処理 取引・通知を受けて更新する処理 変更後の状態がアプリとサーバーで一致すること

Transaction.currentEntitlementsは、ユーザーが現在保有する権利を確認するためのStoreKit 2の情報源です。ただし、アプリ独自のメンバー権限や席の割り当てをそれだけで確定できるとは扱わず、currentEntitlementsの公式仕様と自社の認可処理を分けて設計してください。

02 App Store Connectで購入対象と設定を切り分ける

Group Purchasesの設定を確認するときは、対象の自動更新サブスクリプションと、現在のApp Store Connect上の購入オプションを記録します。実際の設定項目や利用条件は、機能の公開後に画面とAppleの説明で確かめてください。公開前に見えない設定や資格条件を推測して、手順書に確定情報として書くのは避けます。

確認する項目 Group Purchasesの検証 組織向け一括購入との違い
購入の目的 アプリ内のサブスクリプションを複数メンバーで利用する流れ 組織がアプリやコンテンツをまとめて取得する流れ
確認先 対象サブスクリプションの購入オプションと公開後の案内 Apple BusinessまたはApple School Managerの購入・配布手順
テスト記録 購入者、招待、席、アプリ権限の変化 組織の購入・配布状況と管理者の手順

この二つを同じ「複数ユーザー向け購入」として扱うと、招待と席の受け入れ検証に必要な記録が抜けます。サブスクリプションの購入オプションはApp Store Connectの管理ガイドを参照し、組織の一括購入とは別の試験計画にしてください。

03 公開後のSandbox Apple Accountで購入と招待を追う

Appleは、2026年11月からSandbox Apple AccountでGroup Purchasesを設定・テストできると案内しています。一方、サンドボックスの具体的な開始日や、画面・APIの細部までがこの告知で確定したわけではありません。実際に検証を始める時点で、Appleのサンドボックス購入テスト手順とApp Store Connectの最新表示を確認してください。

公開後は、次の順に一つずつ記録します。

  • [ ] 購入者役と招待メンバー役を識別できるSandbox Apple Accountを準備します。アカウントの条件や必要数は、公開されたAppleの説明に従います。
  • [ ] 対象サブスクリプションとApp Store Connectの設定状態を記録し、購入前のアプリ権限を確認します。
  • [ ] 購入者の操作からStoreKit 2の購入要求、取引検証、アプリ内の状態更新までを追跡します。
  • [ ] Appleが提供する標準の席管理経路に沿って招待を送り、受諾前後のメンバー状態と席の割り当てを記録します。
  • [ ] 購入者とメンバーそれぞれについて、取引情報、席の状態、利用できるアプリ機能が一致するか照合します。
  • [ ] 招待の未受諾やメンバー変更など、製品で扱う状態変化を試し、失敗時のログと復旧手順を残します。

招待リンクの形式や画面上の操作を、公開前に決め打ちしてはいけません。公式セッションと公開後のドキュメントで確認できる範囲だけを試験手順に反映します。特に「購入できた」ことと「メンバーが正しく権限を得た」ことは別の合格条件です。

04 メンバー変更後のサーバー処理を照合する

購入者とメンバーの状態は、同じタイミングで同じ経路から更新されるとは限りません。アプリ画面だけでなく、サーバーが保持する購入者ID、メンバーID、席の割り当て、権限判定の記録を並べて確認してください。サブスクリプションの更新やキャンセルを受けたときに、利用権限をどの処理で見直すかもテスト対象です。

独自のメンバー管理を実装する場合は、標準の席管理とカスタム処理を区別します。Appleにはグループメンバー取得のためのGet Group Members API仕様がありますが、実際に使える条件やGroup Purchasesとの適用範囲は、公開時点の公式ドキュメントで照合してください。サーバー通知を扱う設計なら、App Store Server Notificationsの受信ガイドに沿って通知処理の記録と再処理方針を用意します。

05 Xcode CIでシミュレーションとサンドボックスの証拠を分ける

Xcode CIでは、テストが通ったという結果だけでなく、後から同じ条件を確認できる記録を残します。最低限、コードのリビジョン、Xcodeの環境情報、テスト方式、利用したアカウントの種別、取引検証結果、席・権限の期待値と実測状態を結び付けてください。秘密情報や認証情報はログに出さず、テストアカウントの識別子も運用ルールに従って扱います。

Xcode内のStoreKitテストは開発中の購入処理の検証に使えますが、AppleのSandbox Apple Accountを使った検証と同じ証拠ではありません。AppleもXcodeとサンドボックスを段階に応じて使い分ける説明を公開しています。(開発各段階でのXcode・サンドボックステスト)

  • XcodeのStoreKitテスト結果には、シミュレーションで確認した範囲を明記します。
  • サンドボックスの結果には、公開後の機能で実施した購入・招待・席の確認を記録します。
  • CIの成功条件に、アプリのビルドだけでなく取引検証と権限照合の結果を含めます。
  • 失敗時は、再現条件、対象ユーザーの役割、サーバー側の状態、復旧後の結果を保存します。

06 リリース判定は購入成功ではなく証拠で行う

試験結果をもとに、機能を試験的に提供するか、公開を進めるか、いったん保留するかを決めます。少なくとも購入者の取引検証、招待後のメンバー権限、席の増減に伴う状態、エラーからの復旧を確認できなければ、単独購入の成功だけでリリース可とは判断しないでください。

判定 必要な証拠 次の対応
受け入れ継続 購入・招待・席・権限の対応関係が記録され、未確認項目が特定されている 公開後のサンドボックスで未確認の経路を試す
試験提供を検討 購入とメンバー権限の一致を確認し、失敗時の記録と復旧手順がある 対象範囲を限定して運用上の問題を監視する
公開を保留 席の状態や権限に不一致がある、または必要なApple仕様が未確認 仕様更新を待ち、テスト計画と実装を再確認する

正式なApp Storeでの提供時期について、Appleの告知は2026年冬としています。特定の日付に読み替えず、サンドボックスの公開状態とともに公式告知を更新時に再確認してください。

07 よくある確認事項

Group Purchasesのサンドボックス検証はいつ始められますか?

Appleの告知では、2026年11月からSandbox Apple Accountで設定とテストが可能になるとされています。具体的な開始日や利用できる画面・操作は告知だけでは確定しません。実際に試す前にApple Developerの最新情報とApp Store Connectの案内を再確認し、公開前は実装準備と既存テストにとどめてください。

StoreKit 2で複数席の招待と割り当てをどう確認しますか?

購入者の購入処理と、招待を受けたメンバーの受諾後の状態を別々に記録します。各時点で取引の検証結果、席の状態、アプリ側の権限を照合してください。標準の席管理と独自のメンバー管理では確認方法が異なるため、実際に公開されたAppleの説明に沿って検証します。

Sandbox Apple Accountはどのように準備すればよいですか?

購入者役とメンバー役を区別できる専用のSandbox Apple Accountを用意し、誰がどの操作を行ったかを記録できる状態にします。必要なアカウントの条件や招待に使える組み合わせは、未公開の仕様を推測せず、サンドボックス機能の公開後にAppleの最新案内で確認してください。

Xcode CIで取引とアプリ内権限を再確認するには?

CIではビルド識別情報、テスト方式、アカウントの種別、実行結果、取引検証と権限確認の記録をひとまとまりに保存します。XcodeのStoreKitテストとAppleのサンドボックスを使った実購入テストは同じ証拠ではありません。CIの成功だけで実際の招待・席割り当てまで通過したと判断しないでください。

手元にMacがあれば、ローカルで基礎的なStoreKitテストを続ける方法もあります。ただし、CI用の環境を自分で保守すると、Xcodeの実行環境管理や常時稼働の確保が必要になり、Linux環境だけではXcodeを動かせず、手元のMacに検証作業が集中することもあります。長期にわたる高負荷運用や物理デバイス接続が必要なら、自前のMacが適する場合もあります。短期間だけXcode CIの実機能に近い検証環境が必要で、Macを購入せずに試したい場合は、CALMVPSの料金と利用条件を確認し、要件に合えばリモートMacの利用方法を検討してください。