Data API には、次の上限と割り当てが適用されます。
割り当ての適用方法
Google アナリティクス Data API v1 へのリクエストにはすべて Google Cloud プロジェクトが必要であり、このページに記載されている割り当てが適用されます。割り当ては、呼び出し元のプロジェクトの識別に使用される方法に関係なく消費されます。たとえば、次のような場合です。
- OAuth 2.0 認証情報で認証されたリクエスト。
- API キーのみを使用して認証されたリクエスト。
API キーは、割り当てと課金の目的で、リクエストを特定の Google Cloud プロジェクトに関連付けるために使用されます。プロジェクトの認証情報または API キーを使用して行われたすべての API 呼び出しは、プロジェクトと Google アナリティクス プロパティに適用される割り当てにカウントされます。
割り当てカテゴリ
Data API には、コア、リアルタイム、ファネルの 3 つのリクエスト割り当てカテゴリがあります。コア メソッドに対する API リクエストは、コア割り当てを消費します。リアルタイム メソッドに対する API リクエストは、リアルタイム割り当てを消費します。各リクエストは 1 種類の割り当てのみを消費します。
| 割り当てカテゴリ | API メソッド |
|---|---|
| コア | runReport、runPivotReport、batchRunReports、batchRunPivotReports、runAccessReport、getMetadata、checkCompatibility、createAudienceExports |
| リアルタイム | runRealtimeReport |
| ファネル | runFunnelReport |
アナリティクス プロパティの割り当て
すべてのリクエストでプロパティの割り当てが消費されます。
| 割り当て名 | 標準プロパティの上限 | アナリティクス 360 プロパティの上限 |
|---|---|---|
| 1 プロパティあたりの 1 日のコアトークン数 | 200,000 | 2,000,000 |
| 1 プロパティあたりの 1 時間のコアトークン数 | 40,000 | 400,000 |
| 1 プロジェクト、1 プロパティあたりの 1 時間のコアトークン数 | 14,000 | 140,000 |
| 1 プロパティあたりのコア同時リクエスト数 | 10 | 50 |
| 1 プロジェクト、1 プロパティあたりの 1 時間のコアサーバーエラー数 | 10 | 50 |
| 1 プロパティあたりの 1 日のリアルタイム トークン数 | 200,000 | 2,000,000 |
| 1 プロパティあたりの 1 時間のリアルタイム トークン数 | 40,000 | 400,000 |
| 1 プロジェクト、1 プロパティあたりの 1 時間のリアルタイム トークン数 | 14,000 | 140,000 |
| 1 プロパティあたりのリアルタイム同時リクエスト数 | 10 | 50 |
| 1 プロジェクト、1 プロパティあたりの 1 時間のリアルタイム サーバーエラー数 | 10 | 50 |
| 1 プロパティあたりの 1 日のファネル トークン数 | 200,000 | 2,000,000 |
| 1 プロパティあたりの 1 時間のファネル トークン数 | 40,000 | 400,000 |
| 1 プロジェクト、1 プロパティあたりの 1 時間のファネル トークン数 | 14,000 | 140,000 |
| 1 プロパティあたりのファネル同時リクエスト数 | 10 | 50 |
| 1 プロジェクト、1 プロパティあたりの 1 時間のファネル サーバーエラー数 | 10 | 50 |
- 同時リクエストは、同時に実行されるリクエストの数で測定されます。リクエストの同時実行数を減らすには、前のリクエストが完了してから追加のリクエストを送信してください。
- サーバーエラーは 500 と 503 のコードです。サーバーエラーの割り当ては、リクエストがサーバーエラーになった場合にのみ課金されます。プロジェクトとプロパティのペアでサーバーエラーの割り当てが使い果たされると、そのプロジェクトからプロパティへのすべてのリクエストがブロックされます。エラー レスポンスの完全なリストについては、 エラー レスポンスをご覧ください。
- 各リクエストは、「1 プロパティあたりの 1 時間のトークン数」と「1 プロジェクト、1 プロパティあたりの 1 時間のトークン数」の両方の割り当てを消費します。つまり、「1 プロジェクト、1 プロパティあたりの 1 時間のトークン数」の割り当てよりも先に「1 プロパティあたりの 1 時間のトークン数」の割り当てが使い果たされるには、1 つのプロパティに 3 つ以上のプロジェクトからアクセスする必要があります。
プロパティでは、1 時間あたり 120 件のしきい値が適用される可能性のあるリクエストが許可されます。ディメンション userAgeBracket、userGender、brandingInterest、audienceId、audienceName には、しきい値が適用される可能性があります。個々のユーザーのユーザー属性またはインタレスト カテゴリが、レポートを表示するユーザーに推測されないようにする手段として、しきい値が適用されます。
プロパティ トークンの割り当て
Google アナリティクス Data API v1 へのリクエストごとにトークンが消費されます。課金されるトークンの数は、リクエストの複雑さによって異なります。ほとんどのリクエストでは 10 個以下のトークンが課金されますが、複雑なリクエストではより多くのトークンが消費されます。
トークンの消費に影響する要因
リクエストの正確なトークン費用は実行時に決定されるため、事前に正確に計算することは困難です。費用は、リクエスト自体に関連する要因と、Google アナリティクスのプロパティの基盤となるデータの組み合わせによって影響を受けます。これらの要因により、費用が高くなる可能性があります。
- 行数: より多くの行をリクエストする。
- ディメンションと指標の数: より多くのディメンションと指標を含める。
- フィルタの複雑さ: 複雑なフィルタ式を使用する。
- 期間の長さ: より長い期間にわたってクエリを実行する。
- データのカーディナリティ: カーディナリティの高いディメンション（固有の値が多いディメンション。
pagePath、カスタム ディメンションなど）は、トークン費用を大幅に増加させる可能性があります。 - プロパティのイベント数: イベント数の多いプロパティに対するクエリでは、データ量の少ないプロパティに対する同じクエリよりも多くのトークンが消費される可能性があります。
トークンの使用状況のモニタリング
特定 API 呼び出しのトークン費用を判断する最も効果的な方法は、
リクエスト本文に "returnPropertyQuota": true パラメータを含めることです。
API レスポンスには PropertyQuota
オブジェクトが含まれます。このオブジェクトには、特定のリクエストによって消費されたトークンと、残りの割り当て残高の詳細が記載されています。