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 日あたりのプロパティあたりのコアトークン数 | 200,000 | 2,000,000 |
| 1 時間あたりのプロパティあたりのコアトークン数 | 40,000 | 400,000 |
| 1 時間あたりのプロジェクトあたりのプロパティあたりのコアトークン数 | 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 |
| 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 オブジェクトが含まれます。このオブジェクトには、特定のリクエストで消費されたトークンと、残りの割り当て残高の詳細が記載されています。