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