Data API の制限と割り当て

Data API には次の上限と割り当てが適用されます。

割り当ての適用方法

Google アナリティクス Data API v1 に対するすべてのリクエストには Google Cloud プロジェクトが必要であり、このページで説明する割り当てが適用されます。割り当ては、呼び出し元プロジェクトの特定に使用される方法に関係なく消費されます。たとえば、次の方法があります。

  • OAuth 2.0 認証情報で認証されたリクエスト。
  • API キーのみを使用して認証されたリクエスト。

API キーは、割り当てと課金の目的で、リクエストを特定の Google Cloud プロジェクトに関連付けるために使用されます。プロジェクトの認証情報または API キーを使用して行われたすべての API 呼び出しは、プロジェクトと Google アナリティクス プロパティの該当する割り当てに対してカウントされます。

割り当てカテゴリ

Data API には、コア、リアルタイム、ファネルの 3 つのリクエスト割り当てカテゴリがあります。Core メソッドに対する API リクエストは、Core 割り当てを消費します。リアルタイム メソッドに対する API リクエストは、リアルタイム割り当てを消費します。各リクエストは 1 種類の割り当てのみを消費します。

割り当てカテゴリ API メソッド
コア runReportrunPivotReportbatchRunReportsbatchRunPivotReportsrunAccessReportgetMetadatacheckCompatibilitycreateAudienceExports
リアルタイム runRealtimeReport
ファネル runFunnelReport

アナリティクスのプロパティの割り当て

すべてのリクエストはプロパティの割り当てを消費します。

割り当て名 標準プロパティの上限 アナリティクス 360 プロパティの上限
プロパティごとの 1 日あたりのコア トークン数 200,000 2,000,000
同一プロパティで 1 時間あたりのコアトークン数 40,000 400,000
同一プロジェクト・同一プロパティで 1 時間あたりのコア トークン数 14,000 140,000
プロパティあたりのコア同時リクエスト数 10 50
同一プロジェクト・同一プロパティで 1 時間あたりのコアサーバーエラー数 10 50
Realtime Tokens Per Property Per Day 200,000 2,000,000
Realtime Tokens Per Property Per Hour 40,000 400,000
Realtime Tokens Per Project Per Property Per Hour 14,000 140,000
プロパティあたりのリアルタイム同時リクエスト数 10 50
同一プロジェクト・同一プロパティで 1 時間あたりのリアルタイム サーバーエラー数 10 50
プロパティあたりの 1 日のファネル トークン数 200,000 2,000,000
同一プロパティで 1 時間あたりのファネル トークン数 40,000 400,000
同一プロジェクト・同一プロパティで 1 時間あたりのファネル トークン数 14,000 140,000
プロパティあたりのファネル同時リクエスト数 10 50
ファネルのサーバーエラー数(同一プロジェクト・同一プロパティで 1 時間あたり) 10 50
  • 同時リクエストは、同時に実行されているリクエストの数で測定されます。リクエストの同時実行数を減らすには、前のリクエストが完了するまで待ってから、追加のリクエストを送信します。
  • サーバーエラーは 500 コードと 503 コードです。サーバーエラーの割り当ては、リクエストがサーバーエラーになった場合にのみ課金されます。プロジェクトとプロパティのペアでサーバーエラーの割り当てが使い果たされると、プロジェクトからプロパティへのすべてのリクエストがブロックされます。
  • 各リクエストは、「同一プロパティで 1 時間あたりのトークン数」と「同一プロジェクト・同一プロパティで 1 時間あたりのトークン数」の両方の割り当てを消費します。つまり、1 つのプロパティに 3 つ以上のプロジェクトからアクセスが発生しない限り、「同一プロジェクト・同一プロパティで 1 時間あたり」クォータよりも先に「同一プロパティで 1 時間あたり」クォータを使い切ってしまうことはありません。

プロパティごとに 1 時間あたり 120 件のリクエストが許可されます。ディメンション userAgeBracketuserGenderbrandingInterestaudienceIdaudienceName は、しきい値が設定されている可能性があります。個々のユーザーのユーザー属性またはインタレスト カテゴリが、レポートを表示するユーザーに推測されないようにする手段として、しきい値が適用されます。

プロパティ トークンの割り当て

トークンは、リクエストの複雑さに応じてリクエストごとに計算されます。ほとんどのリクエストでは、10 個以下のトークンが課金されます。リクエストで大量の割り当てトークンが消費される場合、次の要因が考えられます。

  • 行数が多すぎる
  • 列数が多い
  • 複雑なフィルタ条件
  • 長い期間

API リクエストごとに、リクエスト本文で "returnPropertyQuota": true を指定して、現在のプロパティ割り当てトークンのステータスを返すことができます。このステータスには、このリクエストで消費された量と、各割り当てグループの残りの量の両方が含まれます。たとえば、RunReportRequest でこのパラメータを指定することを検討してください。