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 アドレスごとの秒間クエリ数(QPS)は 10 件。
    • API Console には、「ユーザーあたりの 100 秒あたりのリクエスト数」という同様の割り当てがあります。デフォルトでは、ユーザーごとに 100 秒あたり 100 リクエストに設定されていますが、最大 1,000 まで調整できます。ただし、API に対するリクエスト数は、ユーザーごとに 1 秒あたり 10 件までに制限されています。
    • アプリケーションがすべての API リクエストを 1 つの IP アドレスから行う場合(つまり、ユーザーに代わってリクエストを行う場合)は、各リクエストで userIP または quotaUser パラメータを使用して、各ユーザーに QPS の上限をすべて割り当てます。詳細については、標準クエリ パラメータの概要をご覧ください。

Management API

以下の Management API へのリクエストには割り当てが適用されます。

Write API

書き込み(insertupdatepatchdelete)リクエストには、以下の割り当てが適用されます。

  • プロジェクトあたり 1 日 50 件の書き込みリクエスト(引き上げ可能
  • アカウント ID ごとの 1 秒あたりのクエリ数は 1.5 件

書き込みリクエストのエラー

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

  • 1 時間あたり書き込みリクエスト 50 件まで。

1 時間あたり 50 件を超えて、エラーになった書き込みリクエストを送信しようとすると、次のエラーが発生します。

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

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

Data Import API

以下の割り当ては、Uploads リソースに固有のものです。

  • 拡張データのインポートに関する全期間のストレージ上限(Collection API と SDK から送信されたヒットデータには適用されません):
  • プロパティあたり 50 データセット
  • プロパティあたり 1 日 50 件のアップロード操作
  • アップロード ファイルあたり 1 GB
  • 費用データに適用される上限:
    • データセットあたり 1 日 100 MB(ga:date)。たとえば、2014 年 10 月 10 日にまず 50 MB のデータをアップロードし、同じ日に 50 MB を追加でアップロードした場合、そのデータセットについては 2014 年 10 月 10 日の上限 100 MB に達したことになります。

Experiments API

以下の割り当ては、ウェブテストにのみ適用されます。

  • ビュー(旧プロファイル)あたり 12 件のウェブテスト

次のいずれかの statuses を持つテストは、この割り当てにカウントされます。

  • DRAFT
  • READY_TO_RUN
  • RUNNING

1 日では終わらなかった(ステータスが ENDED にならなかった)ウェブテストは、この割り当てではカウントされません。

Unsampled Reports API

以下の割り当ては、非サンプリング レポートにのみ適用されます。

  • 非サンプリング レポートを作成する API リクエストは、一般的な書き込みリクエストの割り当てとしてはカウントされません。
  • API では、管理画面で非サンプリング レポートを作成する場合と同じ、プロパティごとの 1 日あたりのトークン システムが使用されます。
  • 非サンプリング レポートは最大 3,500 件作成できます。この上限に達した状態で API を使ってさらに非サンプリング レポートを作成しようとすると、次のエラーが発生します。
    Error creating this entity. You have reached the maximum allowed entities of this type.

User Permission API

以下の割り当ては、ユーザー権限にのみ適用されます。

  • アナリティクス アカウントは、ユーザーあたり 100 個まで作成できます。アナリティクス アカウントを 100 個所有しているユーザーを新しいアカウントに追加すると、エラーになります。

ユーザー権限へのバッチ書き込み(deleteinsertupdate)リクエストには、次の割り当てが適用されます。

  • バッチ処理のリクエストあたり、ユーザー権限を対象とする書き込みリクエストは 300 件まで
  • ユーザー権限を対象にバッチ処理される 30 件の書き込みリクエストは、1 件の書き込みリクエストとしてカウント

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

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

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

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

プロジェクトの使用量上限を確認して変更する手順、または割り当ての増加をリクエストする手順は次のとおりです。

  1. プロジェクトの請求先アカウントをまだ保有していない場合は、アカウントを作成します。
  2. API Console で 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 の Analytics API で確認できます。

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