よくある質問
割り当ての管理と追加
- 割り当て増加の資格がありますか?
- アナリティクス API v3 リクエストの 1 日の割り当ての上限はどれくらいですか?
- Management API の書き込みリクエストの割り当て増量上限はどれくらいですか?
- Management API リクエストをバッチ処理して割り当てを節約できますか?
- このプロジェクトでは Analytics API の割り当て使用率は低いものの、新しいプロジェクトのリリースに向けて準備を進めており、ユーザー数が大幅に増加する見込みです。一時的に割り当ての増加をリクエストすることはできますか?
- Analytics API リクエストの割り当て使用量が、プロジェクトで現在許可されている割り当てを大幅に下回っています。増加した割り当ては失われますか?
- API リクエストの 1 日あたりのデフォルトの割り当ては 50,000 です。100 万本依頼できますか?
- 割り当ての増加リクエストが承認されたというメールが届きましたが、変更が表示されません。これはなぜですか?
- 割り当ての増加リクエストを送信しましたが、数日経っても連絡がありません。これはなぜですか?
- 割り当ての増加リクエストが拒否されました。承認を受けるにはどうすればよいですか?
- Analytics API リクエストのエラー率が高いのですが、増加した割り当ては失われますか?
- 割り当てに関係なく、ビュー(旧プロファイル)あたり 10,000 件を超える API リクエストを送信すると、
dailyLimitExceeded
エラーが発生します。これはなぜですか? - Real Time Reporting API リクエストの割り当て上限はどれくらいですか?
- 「内部サーバーエラー」とはどういう意味ですか?
- Core Reporting API v3 を使用していますが、Google アナリティクス Reporting API v4 に移行したほうがよいのはなぜですか?
- Core Reporting API v3 と Google アナリティクス Reporting API v4 の両方で、増加した割り当てを維持できますか?
- 割り当てを増やすことはできますか?
- 追加の割り当てをリクエストするをご覧ください。
- アナリティクス API v3 では、1 日に最大何件までリクエストを送信できますか?
- ユーザーあたりの秒間クエリ数(QPS)の最大数は 10 です。つまり、ユーザーごとに 1 日あたり最大 864,000 件のリクエストを実行できます。プロジェクトごとの秒間クエリ数(QPS)の最大数は 20 です。つまり、プロジェクトごとに 1 日あたり最大 1,728,000 件のリクエストを送信できます。
- Management API の書き込みリクエストの割り当てを増やす上限はいくつですか?
- Management API の書き込みリクエストのプロジェクトごとの 1 日あたりの最大割り当ては 500 です。通常は、プロジェクトごと 1 日あたり 1,000~2,000 件を超える書き込みリクエストは許可されません。場合によっては、一時的に上限が引き上げられることがあります。割り当ての増加リクエスト フォームに理由を記載してください。
- Management API のリクエストをバッチ処理して、割り当てを節約することはできますか?
- User Permission API リクエストの場合は、リクエストをバッチ処理して割り当てを節約できます。その他の API リクエストの場合、次のことはできません。バッチ リクエストのすべてのエントリは、プロジェクトの 1 日の割り当てにカウントされます。
- 現在、アナリティクス API 割り当ての使用率はそれほど高くありませんが、新しいサービスの開始を予定しており、ユーザーが大幅に増えると予想されます。一時的に割り当ての増加をリクエストできますか?
- 頻繁に発生する API リクエストのエラー率を低く維持できるように、まず現実的な負荷をテストすることを強くおすすめします。
- アナリティクス API リクエストの割り当ての使用量が、プロジェクトに設定されている現在の上限を大幅に下回っています。増加した割り当ては失われますか?
- Google は API リクエストの割り当て使用量を確認し、使用量が長期間(数か月間)一貫して少ない場合や、API リクエストのエラー率が大幅に増加している場合は、割り当ての増加を取り消します。
- API リクエストの 1 日あたりのデフォルトの割り当ては 50,000 です。1,000,000 として請求できますか?
- 1 日あたりの割り当て増加率の上限は 100% です。このため、お客様の場合は 100,000 件までしか増やすことができません。プロジェクトの需要の増加に応じて、追加の割り当てをリクエストできます。
- 割り当ての追加リクエストが承認されたとのメールが届きましたが、増加を確認できないのはなぜですか?
- 割り当ての増加が有効になるまで、最長で 24 時間かかります。48 時間経過しても増加を確認できない場合は、承認確認メールの返信にてお知らせください。
- 割り当ての追加リクエストを送信しましたが、数日経っても回答がないのはなぜですか?
- リクエストから 48 時間経っても回答がない場合は、Google にお問い合わせになる前に、割り当てリクエスト フォームに必要事項を記入し、最小要件を満たしていることをご確認ください。
- 割り当ての追加リクエストが不承認になりました。承認を受けるにはどうすればよいですか?
- 割り当ての増加リクエストが拒否された場合は、拒否メールに記載されている問題に対処してください。(1)提案された割り当て増加を使用する理由がわからない場合、または(2)プロジェクトのエラー率が高い場合、割り当ては増加しません。
- アナリティクス API リクエストのエラー率が高いのですが、増加した割り当ては失われますか?
- 可能性はかなり高い。Google は API リクエストの割り当て使用量を確認し、使用量が長期間(数か月など)低かった場合や、API リクエストのエラー率が増加した場合は、割り当ての増加を取り消します。
- 割り当てに関係なく、ビュー(プロファイル)あたり 10,000 件を超える API リクエストを送信すると、
dailyLimitExceeded
エラーが発生します。なぜですか? - ビュー(プロファイル)あたりの API リクエスト 10,000 件の割り当ては、引き上げることはできません。
- Real Time Reporting API リクエストの割り当て上限はどれくらいですか?
- プロジェクトごとに 1 日あたり 50,000 リクエスト、IP アドレスごとに 10 QPS(秒間クエリ数)
- 内部サーバーエラーが発生した場合は、どう対処すればよいですか?
- 指数バックオフを実装して API リクエストを再送信します。同じリクエストがレスポンス コード
500
で常に失敗する場合、またはレスポンス コード500
で失敗するリクエストが多数表示される場合は、Google までお問い合わせください。 - Core Reporting API v3 を使用していますが、Google アナリティクス Reporting API v4 に移行したほうがよいのはなぜですか?
- v4 に実装されている機能のみを使用します。また、Reporting API v4 は、v3 よりも高い QPS を可能にする、より柔軟な割り当てモデルを採用しており、今後も進化してまいります。
- Core Reporting API v3 と Google アナリティクス Reporting API v4 の両方で、増量された割り当てを維持できますか?
- いいえ。v3 のリクエスト割り当てを
x
に増やしたとします。v4 に移行すると、v4 のx
も付与されますが、v3 の割り当ては、API v4 の割り当てが増加してから約 3 か月続く移行期間の終了時にデフォルトの割り当てに戻ります。
API の利用状況の監視と記録
- 特定のコードのエラーを確認するにはどうすればよいですか?
- アプリケーションをエンドユーザーのマシン(ブラウザのアドオンなど)にインストールしている。ログの取得、エラーのトラブルシューティング、使用状況のモニタリングを行うにはどうすればよいですか?
- 特定のコードのエラーはどのように確認できますか?
- Google アナリティクス Reporting API v4 以降では、デベロッパー コンソールを使用して、API リクエストをレスポンス エラーコード別に分類して確認できます。現在のところ、デベロッパー コンソールを使用して個々のリクエストのデータを表示することはできません。
- エンドユーザーのパソコンにアプリケーション(ブラウザのアドオンなど)がインストールされていますが、ログの取得、エラーのトラブルシューティング、使用状況のモニタリングを行う方法を教えてください。
- Google Analytics API では、こうした情報に一元的にアクセスできる方法は現在提供されていません。当面は、 Google アナリティクス イベント トラッキングを実装して API エラーを追跡できます。