使用制限

使用上限は、自動プロセスがディスプレイ＆ビデオ 360 API を不適切な方法で使用することを防ぎ、Google のインフラストラクチャを保護します。つまり、あるデベロッパーの操作によってコミュニティに悪影響が及ぶ事態を防ぎます。

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

Display & Video 360 API では、次の 2 種類の上限が使用されます。

  • 割り当ての合計上限。関連するすべてのリクエストがカウントされます。
  • 書き込み割り当て上限。書き込みメソッドに対して行われた関連するすべてのリクエストがカウントされます。書き込みメソッドは、リソースを変更するメソッド（create、patch、delete、bulkEdit など）として定義されます。一部の方法では、他の方法よりも多くの書き込み割り当てが消費されます。

プロジェクトがこれらのいずれかの上限を超えると、スロットリングが発生する可能性があります。

プロジェクト全体の割り当て上限

以下のデフォルトの割り当て制限は、ディスプレイ＆ビデオ 360 API のすべてのリソースとメソッドの間で共有されます。

  • プロジェクトごとの 1 分あたりの合計リクエスト数: 1500
  • プロジェクトあたりの 1 分あたりの書き込みリクエスト数: 700

広告主固有のリクエスト割り当て上限

リクエスト URL で広告主 ID を指定するメソッドは、「広告主ごと、プロジェクトごと」の追加の割り当て上限にカウントされます。

URL パスに広告主 ID が指定されているリクエスト（advertisers.lineItems サービス、advertisers.creatives サービス、advertisers.channels サービスなど）はすべて、次の割り当て上限にカウントされます。

  • 1 プロジェクトあたりの広告主あたりの 1 分あたりの合計リクエスト数: 300
  • プロジェクトごとの広告主ごとの 1 分あたりの書き込みリクエスト数: 150

書き込み負荷の高いメソッド

次の API メソッドは書き込み負荷が高いため、プロダクト リソースを大量に使用し、他の書き込みリクエストよりも多くの書き込みリクエスト割り当てを使用します。

書き込み負荷の高いメソッドに対して行われたリクエストは、書き込みリクエストの割り当て使用量の計算時に 5 回の書き込みクエリとしてカウントされます。たとえば、1 分間に 100 件の標準書き込みリクエストと 21 件の書き込み負荷の高いリクエスト（いずれも広告主を指定していない）を実行すると、205 件の書き込みクエリ（100 + (21 * 5) = 205）としてカウントされ、1 分あたり 200 件の書き込みクエリという既存の一般的なリクエスト割り当て上限を超えます。

次のメソッドは書き込み負荷が高いと見なされます。

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

万一、API リクエストの上限を超えたためにリクエストが失敗すると、API から HTTP ステータス コードとエラーの理由が返されます。さらに、レスポンス本文にエラーの原因についての詳しい説明が記載されます。

次の一覧に、API リクエストの上限を超えたために発生するリクエスト失敗のエラーと、おすすめの対処方法を示します。

コード RPC メッセージ 推奨される対応
429 RESOURCE_EXHAUSTED リソースが不足している（割り当てを確認するなど）。 Google API コンソールで使用状況を調べて、ワークフローを変更し、異なる広告主の下で行われたリクエストをより並列化するか、一般的にリクエストの送信レートを遅くします。

ディスプレイ＆ビデオ 360 API の割り当て上限の引き上げはリクエストできません。