Data API には次の上限と割り当てが適用されます。
割り当ての適用方法
Google アナリティクス Data API v1 に対するすべてのリクエストには Google Cloud プロジェクトが必要であり、このページで説明する割り当てが適用されます。割り当ては、呼び出し元プロジェクトの特定に使用される方法に関係なく消費されます。たとえば、次の方法があります。
- OAuth 2.0 認証情報で認証されたリクエスト。
- API キーのみを使用して認証されたリクエスト。
API キーは、割り当てと課金のためにリクエストを特定の Google Cloud プロジェクトに関連付けるために使用されます。プロジェクトの認証情報または API キーを使用して行われたすべての API 呼び出しは、プロジェクトと Google アナリティクス プロパティの該当する割り当てに対してカウントされます。
割り当てカテゴリ
Data API には、コア、リアルタイム、ファネル、チャットの 4 つのリクエスト割り当てカテゴリがあります。
Core メソッドに対する API リクエストは、Core 割り当てを消費します。リアルタイム メソッドに対する API リクエストは、リアルタイム割り当てを消費します。ファネル メソッドに対する API リクエストは、ファネル割り当てを消費します。Chat メソッドに対する API リクエストは、Chat 割り当てを消費します。各リクエストは 1 種類の割り当てのみを消費します。
| 割り当てカテゴリ | API メソッド |
|---|---|
| コア | runReport、runPivotReport、batchRunReports、batchRunPivotReports、runAccessReport、getMetadata、checkCompatibility、createAudienceExports |
| リアルタイム | runRealtimeReport |
| ファネル | runFunnelReport |
| チャット | properties.chat |
アナリティクスのプロパティの割り当て
すべてのリクエストはプロパティの割り当てを消費します。
| 割り当て名 | 標準プロパティの上限 | アナリティクス 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 |
| 同一プロパティで 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 日あたりのプロパティあたりのチャット トークン数 | 3,750,000 | 3,750,000 |
| Chat Tokens Per Property Per Hour（プロパティあたりの 1 時間あたりのチャット トークン数） | 500,000 | 500,000 |
- 同時リクエストは、同時に実行されているリクエストの数で測定されます。リクエストの同時実行数を減らすには、前のリクエストが完了するまで待ってから、追加のリクエストを送信します。
- サーバーエラーは 500 コードと 503 コードです。サーバーエラーの割り当ては、リクエストがサーバーエラーになった場合にのみ課金されます。プロジェクトとプロパティのペアでサーバーエラーの割り当てが使い果たされると、プロジェクトからプロパティへのすべてのリクエストがブロックされます。エラー レスポンスの完全なリストについては、エラー レスポンスをご覧ください。
- 各リクエストは、「同一プロパティで 1 時間あたりのトークン数」と「同一プロジェクト・同一プロパティで 1 時間あたりのトークン数」の両方の割り当てを消費します。つまり、「同一プロジェクト・同一プロパティで 1 時間あたり」クォータよりも先に「同一プロパティで 1 時間あたり」クォータを使い切るには、1 つのプロパティに 4 つ以上のプロジェクトからアクセスする必要があります。
プロパティごとに 1 時間あたり 120 件の割り当て上限に達する可能性があるリクエストが許可されます。ディメンション userAgeBracket、userGender、brandingInterest、audienceId、audienceName は、しきい値が設定されている可能性があります。個々のユーザーのユーザー属性またはインタレスト カテゴリが、レポートを表示するユーザーに推測されないようにする手段として、しきい値が適用されます。
プロパティ トークンの割り当て
トークンは、Google アナリティクス Data API v1 へのリクエストごとに消費されます。課金されるトークンの数は、リクエストの複雑さによって異なります。ほとんどのリクエストでは 10 個以下のトークンが課金されますが、より複雑なリクエスト（アナリティクス アドバイザー chat クエリなど）ではより多くのトークンが消費されます。
トークン消費に影響する要因
リクエストの正確なトークン費用は実行時に決定されるため、正確な事前計算は困難です。費用は、リクエスト自体と Google アナリティクスのプロパティの基盤となるデータに関連するさまざまな要因の組み合わせによって決まります。これらの要因により、費用が増加する可能性があります。
- 行数: より多くの行をリクエストしています。
- ディメンションと指標の数: ディメンションと指標の数を増やします。
- フィルタの複雑さ: 複雑なフィルタ式を使用している。
- 期間の長さ: 長い期間でクエリを実行しています。
- データのカーディナリティ: カーディナリティが高いディメンション（
pagePath、カスタム ディメンションなど、一意の値が多い）は、トークン費用を大幅に増加させる可能性があります。 - プロパティのイベント数: イベント数の多いプロパティに対するクエリは、データ量の少ないプロパティに対する同じクエリよりも多くのトークンを消費する可能性があります。
トークンの使用状況をモニタリングする
特定の API 呼び出しのトークン費用を最も効果的に確認するには、リクエスト本文に "returnPropertyQuota": true パラメータを含めます。API レスポンスには、その特定のリクエストで使用されたトークンと残りの割り当て残高の詳細を示す PropertyQuota オブジェクトが含まれます。
チャット トークンの使用量とモニタリング
Analytics Advisor chat リクエストの場合、トークンはモデルの計算、推論、基盤となるデータ取得の費用を表します。チャット トークンの使用量は次の要因に影響されます。
- クエリと分析の範囲: リクエストされた分析の複雑さと範囲。
- モデルの入力トークンと出力トークン: 処理されたコンテキスト データの量と生成されたレスポンスのナラティブ。
- 思考トークン: 検出結果を合成するために必要なモデルの推論ステップ。
- 実行レイテンシ: マルチステップのデータ探索に必要な処理時間。
チャット トークンの使用量をモニタリングするには、ChatRequest で "returnPropertyQuota": true を設定します。レスポンスには、使用済み残高と残高を含む tokensPerDay フィールドと tokensPerHour フィールドを含む PropertyChatQuota オブジェクトが含まれます。