Google Play 2026年のデベロッパー向けレポートAPI
Google Playではすでにコンソール上でクラッシュとANRの数値を確認できます。しかしあの画面は、1つのアプリを、1人の担当者が、半日かけて見るために作られたものです。Play Developer Reporting APIは、もう一方の用途のために存在します。同じ品質データを定期的に、運用中のすべてのアプリから取得し、自社のウェアハウスやアラートパイプラインに取り込むためです。これは2つ目のコンソールではありません。40本のアプリについて同じ問いを、40個のタブを開かずに投げかけるための、正規化された手段です。
このチュートリアルは、2026年に実際に機能する手順を、失敗したときにエラーが現れる順番で示したものです。プロジェクト、サービスアカウント、Play Consoleの権限、アプリの検出、鮮度、クエリ、ディメンション、異常値。各ステップはすべてドキュメント化された呼び出しで、多くのチームがつまずくのはステップ3のPlay Consoleへの招待と、ステップ7のタイムゾーンの思い込みの2か所です。
1. コードを書く前にAPIが何を返すかを知る
このサービスはメトリクスセットを公開しています。これは同じ粒度を共有し、まとめてクエリできる関連メトリクスの論理的なグループです。公開されているセットは、ANR率、クラッシュ率、過剰なウェイクアップ率、スタックしたバックグラウンドwakelock率、スロースタート率、スローレンダリング率、LMK(ローメモリキル)率、匿名RSSとスワップメモリ使用量、ビットマップメモリ使用量、エラー件数をカバーしています。各セットにはcrashRateやuserPerceivedCrashRateといった正規化されたメトリクスと、その横に7日間・28日間のユーザー加重平均が含まれます。
この設計から2つの実用的な事実が導かれます。第一に、これらは集計値であり、ユーザー数の割合やメモリのパーセンタイル値であるため、ユーザーレベルのデータを扱うことなくサーバーからAPIを安全に実行できます。第二に、一部のリソースはバージョン番号が示すよりも範囲が狭くなっています。エラーの件数セットはAPIのv1alpha1バージョンでのみ利用可能で、それ以外ではv1beta1とv1alpha1が同じメソッド構成で同じリソースを公開しています。バージョンはプロジェクト単位ではなく、リソース単位で決めてください。
2. Cloudプロジェクトを作成し、APIを有効にする
Reporting APIを使うにはAPIを有効化したGoogle Cloudプロジェクトが依然として必要ですが、2026年の変更により、これまで計画に組み込まれていたある手順が不要になります。それは、Reporting APIを利用するためにPlay developer accountをCloud Consoleにリンクする必要がなくなったという点です。公式に示されている4つの手順は次のとおりです。Cloudプロジェクトを作成(または再利用)する、そのプロジェクトでGoogle Play Developer Reporting APIを有効化する、サービスアカウントを作成する、そしてPlay Console内でそのサービスアカウントにアクセス権を付与する。
APIの有効化は、Cloud ConsoleのAPIページでワンクリックで行えます。使い捨てのプロジェクトではなく、すでに請求とIAMを保持しているプロジェクトで行いましょう。サービスアカウントキーは作成者より長く生き残り、放置されたプロジェクトは1年後に監視が静かに止まる原因になります。
3. サービスアカウントにスコープを1つだけ付与し、次にPlay Consoleのロールを1つ付与する
サービスアカウントは無人ジョブ向けの文書化された選択肢であり、サーバーから決して外に出してはならないJSONキーで認証する。このAPIのすべての呼び出しは、単一のOAuthスコープに対して認可される:
https://www.googleapis.com/auth/playdeveloperreporting
次に、最初の403エラーを左右する権限です。APIを有効にすることと、データの読み取りを許可されることは別です。Play Consoleのユーザーと権限に移動し、サービスアカウント自身のアドレス(your-name@your-project.iam.gserviceaccount.com)を招待し、照会する指標セットに必要な最小限の権限を付与します。Google自身のガイダンスでは、APIアクションごとに最小限の権限を付与すべきとされており、指標セットによって必要な権限は異なります。レポート作成ジョブに管理者権限、リリース管理、財務アクセスは決して必要ありません。
キーファイルはリポジトリの外に保存し、サービスアカウントはアプリごとではなくポートフォリオごとに1つにしてください。1つの認証情報のローテーションは5分の作業ですが、30個のローテーションは週末がつぶれます。
4. アカウントが参照できるアプリIDを確認する
Before any metric call, resolve which apps the credential can reach. The service endpoint is https://playdeveloperreporting.googleapis.com, and the app list comes from:
GET /v1beta1/apps:search
これをポートフォリオごとに1回実行し、結果をキャッシュしてください。手順3の招待が機能したかを証明する最も安価な方法です。有効なトークンがあるのにリストが空なら、ほぼ間違いなくサービスアカウントが誤ったアカウントに招待されたか、招待されたもののアプリの可視性を含む権限が付与されていません。
5. 数値を信頼する前に鮮度を確認する
各メトリクスセットは、利用可能な最新データポイントのタイムスタンプ、つまり鮮度を返すシンプルなGETに応答します。値はサポートされる粒度(日次・時間別)ごとに1つです。前日のデータが存在すると仮定せず、スケジュール実行のたびにまずここを確認してください。返された鮮度の値をそのままクエリ範囲の終端に使えば、ジョブは自己整合的になります。固定の遅延もなく、静かなリリースの翌朝に空のレスポンスが返ることもありません。
欠損したデータポイントはゼロではありません。範囲が0行を返したためにウェアハウスが0.0%を書き込むと、誰かがコンソールを確認するその日まで、ダッシュボードは完璧なアプリを表示し続けます。
6. POST :queryメソッドでセットをクエリする
データはリスト呼び出しではなく、メトリクスセットリソース上のカスタム:queryメソッドから取得します。各クエリでは、粒度、期間、メトリクス、および内訳のディメンションを指定します。
POST https://playdeveloperreporting.googleapis.com/v1beta1/apps/<package>/crashRateMetricSet:query // body { "timelineSpec": { "aggregationPeriod": "DAILY", "startTime": { "year": 2026, "month": 10, "day": 14 }, "endTime": { "year": 2026, "month": 10, "day": 20 } }, "dimensions": ["versionCode", "countryCode"], "metrics": ["crashRate", "userPerceivedCrashRate", "distinctUsers"], "pageSize": 1000 }
レスポンスは、要求したディメンションをキーとする行のリストに、続きがある場合のpageTokenを加えたものです。filterはディメンションの一致で行を絞り込みます。ページネーションはメトリクスセット間で同じ形式なので、汎用のページャー1つでクラッシュ率、ANR率、メモリのいずれにも対応できます。
7. 意図をもってディメンションを選ぶ — そして2つの時間の罠に注意
ディメンションは、コンソールに対するAPIの真価が発揮される領域です。versionCodeは、全社的なクラッシュ率をリリースごとのリグレッション検査に変えます。countryCodeは、新しいSDKが誤動作する市場を切り分けます。デバイスのディメンション——deviceModel、deviceType、apiLevel、deviceRamBucket、そしてSoC、CPU、GPU、画面の各フィールド——は、「自分たちのコードが壊れた」のか「このチップセットが壊れた」のかを分離します。
2つの時刻の落とし穴が、どのチームにも一度は牙をむきます。日次集計は固定のAmerica/Los_Angelesタイムゾーンを使用すると記載されている一方、時間次集計はUTCに固定されています。あなたの営業日がCSTの場合、日次バケットは思っている時刻には始まらず、現地時間9:00にデプロイしたリリースは2つのバケットにまたがります。2つ目の落とし穴:空の日は多くの場合データの鮮度遅延にすぎません。だからこそステップ5を最初に行うのです。
また、ドキュメントには設計時に考慮すべき厳しいパフォーマンス制限があります。リクエストする範囲のサイズは、アプリのサイズと内訳の数に反比例する必要があります。大規模なアプリで6つのディメンションにわたって30日分を要求するとタイムアウトします。大規模アプリでは、無謀な1回のクエリではなく、短い期間でループしてください。
8. Googleに異常を検出させる
アラートを出すために、これらの指標の上にしきい値の計算を自作する必要はありません。APIにはanomaliesコレクションがあり、いずれかのデータセットでGoogleがすでに検出した異常を、アクティブだった期間で絞り込んで一覧表示します:
GET /v1beta1/apps/<package>/anomalies ?filter=activeBetween("2026-10-19T00:00:00Z","2026-10-21T00:00:00Z") &pageSize=50
両方の境界はUTCオフセットを許容するRFC-3339文字列で、片側だけの期間には特別値UNBOUNDEDも指定できます。pageSizeのデフォルトは10で上限は100です。各アノマリーには種類、重大度、影響するディメンション、関与する指標が付くため、定期ポーリングの結果をそのまま人が対応できるメッセージに変換できます。
レートではなくスタックトレースが必要な場合、同じAPIがエラーイシューとエラーレポート(クラスタ化されたレイヤーと個別のレイヤーの両方)を両バージョンで公開しています。「v1.4.2でクラッシュ率が倍になった」と「動いたフレームはこれだ」の違いはここにあります。
9. スケジュールだけでなく、アカウントのライフサイクルに組み込む
ステップ3で付与した権限はデベロッパーアカウントに紐づくため、アカウントとともに移動します。Playアカウントが移管、ポートフォリオ売却、停止後の再構築などで所有者が変わると、新しい所有者のPlay Consoleでサービスアカウントを再招待する必要があります。そうしないと、すべての呼び出しが403を返す一方で、ダッシュボードは最後に取得した値を表示し続けます。明示的にアラートを設定すべきなのはまさにこの障害モードです。5xxだけでなく、403とアプリ一覧の空応答にもアラートを設定してください。静かに資格情報が外された状態でも、APIは平然と「データなし」を返すからです。
監視は退屈なままに保ちましょう。ポートフォリオごとに1つのサービスアカウント、鮮度を読み取ってから対象のセットをクエリする1つのスケジュール実行、2回目のパスとしての異常ポーリング、そして何も動かなければ沈黙する1日1通のメッセージ。それ以外のすべて — しきい値、トレンドのベースライン、国別ボード — は、配管に再び触れることなく追加できる分析です。
デベロッパーアカウントを大規模に運用中ですか? 運用面は当社が対応します。
メッセージを受け付けました。24時間以内に返信します。
← 編集に戻る