割り当てを使用すると、キャンペーン マネージャー 360 API を不適切な方法で使用する自動プロセスから Google のインフラストラクチャを保護できます。そうすることで、1 人のデベロッパーの行動がより大きなコミュニティに悪影響を与えることがなくなります。
割り当て上限
次のデフォルトの割り当て上限は、すべてのキャンペーン マネージャー 360 API リソースとメソッドで共有されます。
- プロジェクトあたり 1 日 50,000 件のリクエスト - 増やすことができます。
- プロジェクトあたり 1 QPS（秒間クエリ数）
- Google API Console では、この割り当てはユーザーごとの 1 分あたりのクエリ数と呼ばれ、デフォルトでは 60 に設定されています。この上限は、必要に応じて最大 600（10 QPS）まで引き上げることができます。
レポート ビルダーによって、アカウントごとに異なる割り当て制限が適用されます。詳しくは、こちらのヘルプセンター記事と以下の表をご覧ください。
割り当ての上限を超えた場合
万が一、割り当ての上限を超えたためにリクエストが失敗すると、API は HTTP ステータス コードとエラーの理由を返します。また、レスポンス本文にエラーの原因についての詳しい説明が記述されます。エラー レスポンスの例については、エラー メッセージのガイドをご覧ください。
割り当て上限の超過によって発生する可能性のあるリクエスト エラーとその対処方法を以下に示します。
| コード | 理由 | メッセージ | 推奨される対応 |
|---|---|---|---|
| 403 | dailyLimitExceeded | 1 日の上限を超えています | 問題を解決してから再試行します。Google API Console で使用状況を確認し、ワークフローを変更してリクエストの数を減らします。使用量が妥当と考えられる場合は、追加の割り当てをリクエストできます。 |
| 403 | quotaExceeded | このアカウントは、レポートの数が 1 日あたり x 件を超えています。 | この日以降、このアカウントのレポートをそれ以上作成しないでください。アカウント マネージャーにお問い合わせください。 |
| 403 | quotaExceeded | このユーザー プロフィールで設定できるレポート数の上限は 1 日あたり x 件です。 | 当日は、このユーザー プロフィールで今後レポートを生成しないでください。別のユーザー プロフィールに切り替えるか、アカウント マネージャーにお問い合わせください。 |
| 403 | quotaExceeded | このアカウントでスケジュール設定が可能なレポート数（x 件）を超えています。 | このリクエストを再試行する前に、不要なスケジュールに基づくレポートを無効にしてください。 |
| 403 | quotaExceeded | このレポートのユーザー プロフィールで、有効なスケジュール設定済みレポートの数が上限の x 件を超えています。 | このリクエストを再試行する前に、このレポートのオーナーに不要なスケジュール レポートを無効にしてもらいます。 |
| 403 | quotaExceeded | このユーザー プロフィールでスケジュール設定が可能なレポート数（x 件）を超えています。 | このリクエストを再試行する前に、不要なスケジュールに基づくレポートを無効にしてください。 |
| 403 | quotaExceeded | 割り当てを超過したため、この操作を完了できません。アカウント マネージャーにサポートをご依頼ください。 | アカウント マネージャーにお問い合わせください。 |
| 403 | userRateLimitExceeded | ユーザーのレート制限を超えています | Google API Console でユーザーごとの上限を引き上げるか、指数バックオフを使用してリクエストを送信する速度を遅くします。この API では、同時書き込みリクエストを行うことや、10 QPS を超えるレート制限を使用することはおすすめしません。 |
1 日の割り当ての増加をリクエストする
アプリケーションで 1 日の割り当ての増量が必要であると思われる場合は、以下の手順で追加の割り当てをリクエストできます。
次の手順は、dailyLimitExceeded エラーが発生したプロジェクトにのみ適用されます。その他の割り当てエラーに対する推奨される対応については、上の表をご覧ください。
- Google API Console で キャンペーン マネージャー 360 API に移動します。
- [指標] ページの使用統計情報を確認して、アプリケーションが期待どおりに動作していることを確認します。先に進む前に、呼び出されたメソッドに注意し、予期しないまたは過剰な使用があれば対処してください。
- 使用量が正常と思われる場合は、[割り当て] ページに移動し、[クエリ数/日] の横にある編集アイコンをクリックして、[割り当ての増加を申し込む] リンクをクリックします。
割り当てリクエスト フォームの内容を確認して、増加リクエストを送信する前にリクエストしてください。