API リクエストの制限と割り当て

Google アナリティクスは数多くのサイトで使用されています。Google では、システムが処理可能な量を超えるデータを受信することを防ぎ、システム リソースを公平に配分するために、API リクエストに上限と割り当てを設けています。上限と割り当ては変更される場合があります。

こちらの動画では、Google アナリティクス API のリクエストの割り当てを管理するうえで有益なヒントを紹介します。

User Deletion API には、次の割り当てが適用されます。

  • プロジェクトごとに 1 日あたり 50,000 件のリクエスト（引き上げ可能）。
  • IP アドレスごとに 10 件の秒間クエリ数（QPS）。
    • API Console にも、同様の割り当てがユーザーごとの 100 秒あたりのリクエスト数という上限があります。デフォルトでは、ユーザーごとに 100 秒あたり 100 件のリクエストに設定されていますが、1,000 件まで調整できます。ただし、API に対するリクエスト数は、ユーザー 1 人あたり 1 秒あたり最大 10 件に制限されています。
    • アプリケーションですべての API リクエストを（ユーザーに代わって）単一の IP アドレスから行う場合は、各リクエストで userIP または quotaUser パラメータを使用して、各ユーザーの QPS 割り当てをすべて取得します。詳しくは、標準クエリ パラメータの概要をご覧ください。
  • プロパティまたは Firebase プロジェクトごとに、1 秒あたりのクエリ数（QPS）は 1.5 件まで。
  • クラウド プロジェクトごとに 1 日あたりのクエリ数（QPD）は 500 件まで。

割り当ての上限を超えた場合

Google Analytics API のリクエストの割り当てを超過すると、API はエラーコード 403 または 429 と、アカウントが割り当てを超過したことを示すメッセージを返します。詳しくは、利用規約をご覧ください。

割り当ての追加をリクエストする

以下の割り当てにのみ追加をリクエストできます。

  • プロジェクトごとの 1 日の読み取りリクエスト数（デフォルトでは 50,000 件）。
  • プロジェクトごとの 1 日の書き込みリクエストの数（デフォルトは 50）。

プロジェクトの使用量上限を確認して変更する手順、または割り当ての増加をリクエストする手順は次のとおりです。

  1. プロジェクトの請求先アカウントをまだ保有していない場合は、アカウントを作成します。
  2. API Console で API ライブラリの [有効な API] ページに移動し、リストから API を選択します。
  3. 割り当て関連の設定を表示および変更するには、[割り当て] を選択します。使用統計情報を表示するには、[使用量] を選択します。

割り当て上限の引き上げをリクエストするには、Analytics API の割り当てリクエスト フォームを使用します。リクエストを送信する前に、情報を確認し、割り当てリクエスト フォームの手順に沿って操作してください。

割り当ての管理と、割り当ての使用状況に合わせてアプリケーションを微調整する方法については、Monitoring API と使用量の上限設定をご覧ください。