料金
Search Ads 360 API の使用は、検索広告 360 の全体的な料金に含まれます。 API の使用に追加料金はかかりません。
割り当て
Search Ads 360 API では、1 つの Google API プロジェクトが送信できるリクエスト数に対して 1 日あたりの割り当てが割り当てられています。割り当てに達すると、それ以上のリクエストはエラーを返します。このプロジェクトで認証されたすべてのクライアントは、翌日まで待ってから追加のリクエストを送信する必要があります。1 日の割り当ては、午前 0 時（太平洋時間）にリセットされます。
割り当ては次の 3 つのバケットに整理されます。
- Reports.generate(): 実行できる Reports.generate() リクエストの数。
- Reports.request(): 実行できる Reports.request() リクエストの数。この数値は、レポートの生成に必要な計算時間によって異なります。たとえば、小さくシンプルなレポートを多数リクエストしたり、大きくて複雑なレポートを少数リクエストしたりできます。
- デフォルト: レポートのステータスのポーリング、レポートのダウンロード、コンバージョンのリスト表示とアップロードを行うために実行できるリクエストの数。
あるバケットから借用して、別のバケットの割り当てを増やすことはできません。
使用量と割り当てを表示する
現在の使用量を表示して 1 日の割り当てと比較する手順は次のとおりです。
- 認証情報の生成に使用した Google アカウントで Google API Console にログインします。
- API Console で、API ライブラリの [有効な API] ページにアクセスし、リストから Search Ads 360 API を選択します。
- [割り当て] タブをクリックします。[割り当て] タブに、API プロジェクトの使用量と上限が表示されます。デフォルトでは、上限はプロジェクトの割り当てと同じリクエスト数に設定されています。上限を引き下げて、ユーザーがプロジェクトの割り当てを使い切らないようにします。上限は主に、課金対象のプロジェクトや多数のユーザーがいるプロジェクト用です。Search Ads 360 API は課金対象外で、通常、ユーザー数はそれほど多くないため、デフォルト設定のままにしておくことをおすすめします。
- ユーザーが割り当てを下回る上限を設定しているかどうかを確認するには、クエリタイプの横にある編集アイコンをクリックします。ポップアップが表示され、割り当てが表示されます。たとえば、[1 日あたりのレポート生成クエリ数] の横にある編集アイコンをクリックすると、「1 ～ 10,000 の間の数値を入力してください」のようなテキストを含むポップアップが表示されます。この場合、プロジェクトにおけるレポート生成クエリの割り当ては 10,000 件です。
追加の割り当てをリクエスト
リクエストから、割り当て上限の超過を示すエラーが返された場合は、まず使用量と上限を表示して、単純に上限を超えていないことを確認します。すでに最大割り当てに上限を設定している場合は、サポートにお問い合わせのうえ、追加の割り当てをリクエストしてください。