API リクエストの制限と割り当て

このドキュメントでは、Management API および Reporting API のリクエストに設けられた制限と割り当てについて説明します。

Google アナリティクスは数多くのサイトで使用されています。Google では、処理能力を超える負荷がシステムにかからないようにすること、システム リソースが均等に配分されるようにすることを目的に、API リクエストに制限と割り当てを設けています。この制限と割り当ては変更されることがあります。

こちらの動画では、Google アナリティクス API のリクエストの割り当てを管理するうえで有益なヒントを紹介します。

一般的な割り当て制限

以下の割り当ては Management APICore Reporting API v3MCF Reporting APIMetadata APIUser Deletion APIReal Time Reporting API に適用されます。

  • プロジェクトごとの 1 日あたりのリクエスト数は 50,000 件(引き上げ可能)。
  • IP アドレスごとの 1 秒あたりのクエリ数(QPS)は 10 件。
    • API Console には、ユーザーごとの 100 秒あたりのリクエスト数という類似の割り当て制限があります。デフォルトでは、ユーザーごとに 100 秒あたり 100 件のリクエストに設定されています。設定できる最大値は 1,000 件です。ただし、API に対するリクエスト数は、ユーザーごとに 1 秒あたり 10 件までに制限されています。
    • アプリケーションが、すべての API リクエストを 1 つの IP アドレスから行う(つまり、ユーザーに代わってリクエストを行う)場合は、ユーザーごとに QPS が上限まで割り当てられるように各リクエストで userIP パラメータまたは quotaUser パラメータを使用してください。詳しくは、標準クエリ パラメータの概要をご覧ください。

Reporting API

以下の割り当ては、Core Reporting API v3アナリティクス Reporting API v4Realtime API v3Multi-channel Funnel API v3 など、すべての Reporting API に適用されます。

  • ビュー(旧プロファイル)ごとに 1 日 10,000 件のリクエスト(引き上げ不可)
  • ビュー(旧プロファイル)ごとに 10 件の同時リクエスト(引き上げ不可)

Reporting API のリクエスト エラーについて

Reporting API へのリクエストが失敗し、応答コード 500 または 503 が返された場合は再送信できます。Google アナリティクスで許可されているリクエストの失敗件数は次のとおりです。

  • プロジェクトごとのリクエストの失敗は、プロファイルあたり 1 時間 10 件まで
  • プロジェクトごとのリクエストの失敗は、プロファイルあたり 1 日 50 件まで

リクエストの失敗がこの件数を超えると、次のエラーが返されます。

Quota Error: The number of recent failed writes is too high.

エラーになったリクエストは連続的に再送信せず、指数バックオフを設定して再送信してください。

割り当ての上限を超えた場合

Google アナリティクス API に対するリクエストの割り当てが上限を超えた場合、API はエラーコード 403 または 429 に加え、アカウントの割り当てが上限を超えたことを知らせるメッセージを返します。詳しくは、利用規約をご覧ください。

割り当ての追加をリクエストする

以下の割り当てにのみ追加をリクエストできます。

プロジェクトの割り当ての上限を表示、変更する場合や、割り当ての追加をリクエストする場合は、次の手順を行ってください。

  1. プロジェクトの請求先アカウントが まだない場合は作成します。
  2. API コンソールで API ライブラリの 有効な API ページにアクセスし、一覧から API を選択 します。
  3. 割り当て関連の設定を表示および変更するには、[割り当て] を選択します。割り当ての使用状況を確認するには、[使用状況] を選択します。

割り当ての上限の引き上げをリクエストするには、Analytics API の割り当てに関するリクエスト フォームを使用してください。このフォームの情報を確認し、表示される手順に沿ってリクエストをお送りください。Reporting API v4 の場合、Google API Console での API 名は Google アナリティクス Reporting API となります。他のすべての v3 API(Management API v3、Core Reporting API v3、Real Time Reporting API v3、User Deletion API v3 など)は、Google API Console の [アナリティクス API] の下に表示されます。

割り当ての管理や、割り当てを効率的に使うためのアプリケーションの調整について詳しくは、API の監視、割り当ての上限設定をご覧ください。