使用制限

使用量上限は、自動化されたプロセスが Display & Video 360 API を不適切な方法で使用することを防ぎ、Google のインフラストラクチャを保護するものです。1 人のデベロッパーの行為が、より大きなコミュニティに悪影響を与えることを防ぐ。

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

Display & Video 360 API には次の 2 種類の制限が適用されます。

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

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

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

次のデフォルトの割り当て上限は、すべての Display & Video 360 API のリソースとメソッドで共有されます。

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

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

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

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

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

書き込み集約型のメソッド

次の API メソッドは書き込み集中型です。つまり、大量のプロダクト リソースを使用するため、他の書き込みリクエストよりも書き込みリクエストの割り当てが増加します。

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

次のメソッドは、書き込み集中型とみなされます。

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

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

次のリストは、API リクエストの上限を超えたためにリクエストが失敗する場合のエラーと推奨される対応を示しています。

コード RPC メッセージ 推奨される対応
429 RESOURCE_EXHAUSTED リソースの 不足 （例: 割り当ての確認） Google API Console で使用状況を確認し、異なる広告主からのリクエストを並列化するようにワークフローを変更します。あるいは、リクエストの送信速度を遅くします。

Display & Video 360 API の割り当て上限の引き上げをリクエストすることはできません。