Google Playとの初期連携
Google PlayアカウントをAdaptyに接続することで、AdaptyのサーバーからPlay Storeのプロダクトを読み取り、購入を検証し、Androidのサブスクリプションイベントを受信できるようになります。
各ストアは個別に接続され、それぞれの接続は独立しています。アプリをApp Storeでも配信している場合は、App Store Connect連携を設定してください。
セットアップには約1時間かかります。Adapty ダッシュボードの組み込みオンボーディングでも同じ内容を案内しているので、1つの画面で完結させたい場合はそちらをご利用ください。
始める前に
AppleとはことなAり、Googleは開発者エコシステムをGoogle Play ConsoleとGoogle Cloud Consoleという2つの別製品に分けており、この設定は両方に関わります。
含まれる内容
- サービスアカウント: 個人ではなくマシン用のGoogle アカウントです。Adapty が Google Cloud および Google Play Console にアクセスできるよう、新しいサービスアカウントを作成する必要があります。
- Google Cloud Console: Google の汎用インフラプラットフォームです。Play Store 自体にはAPI 認証情報がないため、こちらで作成します。Cloud Console を使用して、Developer API の有効化、サービスアカウントの作成、および必要な権限の一部付与を行います。Adapty がこれらの権限を必要とするのは、更新・キャンセル・返金の情報を受け取るためです。また、Adapty が Google に認証するために必要なサービスアカウントキーファイルもここからダウンロードできます。
- Google Play Console: アプリを公開してサブスクリプションを販売する場所です。Play Console を使用して、サービスアカウントに残りの必要な権限を付与します。Adapty がこれらの権限を必要とするのは、プロダクト情報の読み取りと購入の検証を行うためです。また、リアルタイムデベロッパー通知（RTDN）を有効にすることで、Play Store と Adapty 間の通信ラインを設定します。
必要なアクセス権限
| コンソール | 必要なもの |
|---|---|
| Google Cloud Console | プロジェクトを新規作成する場合は Project Creator (roles/resourcemanager.projectCreator)。サービスアカウントを作成するには Service Account Creator (roles/iam.serviceAccountCreator)、プロジェクト権限を付与するには Project IAM Admin (roles/resourcemanager.projectIamAdmin) が必要です。Owners はこの3つすべてをデフォルトで実行できます。 |
| Google Play Console | Admin (all permissions)。これにはユーザーを招待する権限が含まれており、サービスアカウントを招待する際に必要です。 |
Google はデフォルトで新しい組織の全員に Project Creator を付与するため、すでに持っている可能性が高いです。ただし、厳格に管理された企業の組織では、この権限が取り消されている場合があります。
必要なリソース
Google Cloud プロジェクト。 まだお持ちでない場合はこちらで作成してください。すでに何かを運用しているプロジェクトを再利用しても構いません。このプロジェクトを使って、Developer API を有効化し、Adapty 用のサービスアカウントを作成します。
プロジェクトは Play Console のアプリとは独立しています。1 つのプロジェクトで複数のアプリの通信を管理できます。各アプリはプロジェクト内に独自のトピック（通信キュー）を持ちます。
Google のサービスを Adapty に接続する際は、最初から最後まで同じプロジェクトを使用してください。個人のプロジェクトより、チームが所有するプロジェクトを選ぶことをおすすめします。キーとトピックは、アプリが存在する限りそこに存在し続けます。
初期連携のチェックリスト
- Google Cloud ConsoleでDeveloper APIを有効化する。
- Google Cloud Consoleでサービスアカウントを作成する。
- Google Play Consoleでサービスアカウントに必要な権限を付与する。
- Google Cloud Consoleでサービスアカウントのキーファイルを生成する。
- Adapty ダッシュボードでキーファイルとパッケージ名をAdaptyにアップロードする。新しいサービスアカウントが有効になるまで少なくとも24時間かかり、それまでAdaptyはプロダクトを読み取れない。この待ち時間をスキップするには、Google Play Consoleで任意のプロダクト説明を編集して保存する。
- Adaptyが生成するトピック名を使って、Google Play Consoleでリアルタイム デベロッパー通知（RTDN）を有効化する。
- アプリが使用する各フレームワーク向けにAdapty SDKをインストールする：
- リリース前に実機でアプリ内課金をテストする。
次のステップ
インテグレーションが完了したら、Adaptyの機能を使い始めることができます。
ペイウォールを表示するには、インテグレーションに加えてアプリのコードが必要です。最低限、ペイウォールを表示する手順と、自分でペイウォールをレンダリングする場合は購入フローを処理する手順を確認してください。
アプリをリリースする前に、リリースチェックリストを確認してください。