割り当て

割り当ては、Google Bid Manager API を不適切な方法で使用する自動プロセスから Google のインフラストラクチャを保護します。開発者の行動が大規模なコミュニティに悪影響を与えることを阻止できる。

割り当て上限

以下のデフォルトの割り当て上限は、すべての Bid Manager API リソースとメソッドで共有されます。

  • プロジェクトごとに 1 日あたり 2,000 リクエスト - 引き上げ可能
  • プロジェクトごとの秒間クエリ数(QPS)は 4 件。
    • Google API Console では、この割り当ては「ユーザーごとの 1 分あたりのクエリ数」と呼ばれ、240 に設定されています。

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

万が一、割り当て上限を超えたためにリクエストが失敗すると、API は HTTP ステータス コードとエラーの理由を返します。また、レスポンスの本文にはエラーの原因の詳細な説明が含まれています。エラー レスポンスの例については、エラー メッセージのガイドをご覧ください。

割り当て上限の超過が原因で発生する、リクエストが失敗する可能性のあるエラーと推奨される対応を以下に示します。

コード 理由 メッセージ 推奨される対応
403 dailyLimitExceeded 1 日の利用時間の上限を超えました 問題を解決してから再試行します。Google API Console で使用状況を確認し、リクエストが少なくなるようにワークフローを変更します。使用量が妥当であると思われる場合は、追加の割り当てをリクエストできます。
403 userRateLimitExceeded ユーザーレートの上限を超えました 指数バックオフを使用して、リクエストの送信頻度を下げます。

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

アプリケーションで 1 日の割り当てを追加する必要があれば、以下の手順に従って追加割り当てをリクエストできます。

次の手順は、dailyLimitExceeded エラーが発生したプロジェクトにのみ適用されます。その他の割り当てエラーに対するおすすめの対処方法については、上記の表をご覧ください。

  1. Google API Console で Bid Manager API に移動します。
  2. [指標] ページの使用統計情報を確認して、アプリケーションが期待どおりに動作していることを確認します。呼び出されているメソッドをよく確認し、予期しない使用や過剰な使用があれば対処してから続行してください。
  3. 使用量に問題がない場合は、[割り当て] ページに移動し、[Queries/day] の横にある編集アイコンをクリックし、[割り当ての増加を申し込む] リンクをクリックします。

割り当てリクエスト フォームに記載されている情報を確認し、その手順に沿って増加リクエストを送信してください。