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 メソッド |
|---|---|
| コア | runReport、runPivotReport、batchRunReports、batchRunPivotReports、runAccessReport、getMetadata、checkCompatibility、createAudienceExports |
| リアルタイム | 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 時間あたり」の割り当てが「同一プロジェクト・同一プロパティで 1 時間あたり」の割り当てよりも先に使い果たされるには、1 つのプロパティが 3 つ以上のプロジェクトからアクセスされる必要があります。
プロパティごとに 1 時間あたり 120 件のリクエストが許可されます。ディメンション userAgeBracket、userGender、brandingInterest、audienceId、audienceName は、しきい値が設定されている可能性があります。個々のユーザーのユーザー属性またはインタレスト カテゴリが、レポートを表示するユーザーに推測されないようにする手段として、しきい値が適用されます。
プロパティ トークンの割り当て
トークンは、Google アナリティクス Data API v1 へのリクエストごとに消費されます。課金されるトークンの数は、リクエストの複雑さによって異なります。ほとんどのリクエストでは 10 個以下のトークンが課金されますが、複雑なリクエストではより多くのトークンが消費されます。
トークン消費に影響する要因
リクエストの正確なトークン費用は実行時に決定されるため、正確な事前計算は困難です。費用は、リクエスト自体と Google アナリティクスのプロパティの基盤となるデータに関連するさまざまな要因によって決まります。これらの要因により、費用が増加する可能性があります。
- 行数: より多くの行をリクエストしています。
- ディメンションと指標の数: ディメンションと指標の数を増やします。
- フィルタの複雑さ: 複雑なフィルタ式を使用している。
- 期間の長さ: 長い期間にわたってクエリを実行しています。
- データのカーディナリティ: カーディナリティの高いディメンション（
pagePath、カスタム ディメンションなど、一意の値が多いディメンション）は、トークン費用を大幅に増加させる可能性があります。 - プロパティのイベント量: イベント量の多いプロパティに対するクエリは、データ量の少ないプロパティに対する同じクエリよりも多くのトークンを消費する可能性があります。
トークンの使用状況をモニタリングする
特定の API 呼び出しのトークン費用を最も効果的に確認するには、リクエスト本文に "returnPropertyQuota": true パラメータを含めます。API レスポンスには、その特定のリクエストで使用されたトークンと残りの割り当て残高の詳細を示す PropertyQuota オブジェクトが含まれます。