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

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

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

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

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

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

  1. プロジェクトの請求先アカウントをまだ保有していない場合は、アカウントを作成します。
  2. API Console で API ライブラリの [有効な API] ページに移動し、リストから API を選択します。
  3. 割り当て関連の設定を表示および変更するには、[割り当て] を選択します。使用統計情報を表示するには、[使用量] を選択します。

割り当ての上限の引き上げをリクエストするには、Analytics API の割り当てリクエスト フォームをご利用ください。リクエストを送信する前に、割り当てリクエスト フォームの情報を確認し、指示に沿って操作してください。Reporting API v4 の場合、Google API Console の API 名は Google Analytics 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 の監視、割り当ての上限設定をご覧ください。