割り当て

Display & Video 360 API 割り当ては、プロジェクトが API にリクエストを送信できるレートを制限します。

ディスプレイ＆ビデオ 360 API の割り当てをより有効に活用するには、以下のおすすめの方法を参考にしてください。

複数の広告主に対して同時にリクエストを行う

ディスプレイ＆ビデオ 360 API の割り当ては、プロジェクトごと、広告主ごとに設定されます。プロジェクトの割り当ては、プロジェクトが行うリクエストを制限します。広告主の割り当ては、プロジェクトから広告主へのリクエストを制限します。

プロジェクトの割り当てをすべて使用するには、複数の広告主に対して同時にリクエストを行います。

list メソッドのクエリパラメータを使用して、必要なリソースのみを含めます。リソースが少ないほど、リストを取得するためのリクエストが少なくなります。

list メソッドには、次の 3 つの主要なパラメータがあります。

pageSize は、リクエストで返されるリソースの数を設定します。デフォルトのページサイズはメソッドによって異なります。この値を最大値に設定すると、リクエストごとに多くのリソースが一覧表示されます。
filter は、指定された条件に基づいてリストされたリソースを制限します。リソースのサブセットのみを一覧表示するには、これを設定します。詳しくは、フィルタリストリクエストをご覧ください。
orderBy は、指定されたプロパティでリストされたリソースを並べ替えます。これを設定すると、リソースリストの上限または下限を少ないリクエストで取得できます。

一括関数とリソース全体の関数は、複雑なタスクを実行します。これらのメソッドに対する 1 つのリクエストで、他のメソッドに対する複数のリクエストを置き換えることができます。

これらのメソッドの詳細については、一括リクエストをご覧ください。

Display & Video 360 API の多くのアクションでは、API を使用して取得した ID が必要です。たとえば、ターゲティングオプション ID や Google オーディエンス ID などがあります。ID をローカルに保存して、繰り返し取得する必要がないようにします。

非推奨または削除されたリソースの ID を使用すると、エラーが返されることがあります。キャッシュに保存された ID のステータスを確認するため、毎週取得する必要があります。

指数バックオフはエラー処理方法です。リクエストは、時間間隔を増やしながら再試行されます。

SDF ダウンロードタスクなどの長時間実行タスクをポーリングする際に、指数バックオフ戦略を使用すると、送信されるリクエストの数を減らすことができます。

SDF ダウンロードのコード例では、クライアントライブラリで指数バックオフを使用しています。指数バックオフフローの例を次に示します。

get リクエストを使用して Operation オブジェクトを取得します。
- done が true でない場合、タスクはまだ実行中です。
- 5 秒 + ランダムな秒数待ってから、リクエストを再試行します。
オペレーションを取得します。
- done が true でない場合、タスクはまだ実行中です。
- 10 秒 + ランダムな秒数の間待機してから、リクエストを再試行します。
オペレーションを取得します。
- done が true でない場合、タスクはまだ実行中です。
- 20 秒 + ランダムな秒数待ってから、リクエストを再試行します。
オペレーションを取得します。
- done が true でない場合、タスクはまだ実行中です。
- 40 秒 + ランダムな秒数待ってから、リクエストを再試行します。
オペレーションを取得します。
- done が true でない場合、タスクはまだ実行中です。
- 80 秒 + ランダムな秒数待ってから、リクエストを再試行します。
done が true になるか、最大経過時間に達するまで、このパターンを続けます。