Search Ads 360 Reporting API では、すべてのユーザーに最適なシステム パフォーマンスを確保するために、API のオペレーションに制限を設けています。
料金
Search Ads 360 Reporting API の使用は、検索広告 360 全体の料金に含まれています。API の使用に追加料金はかかりません。
クエリに関する上限
Search メソッドまたは SearchStream メソッドによって実行されるクエリ オペレーションには、次の上限が適用されます。
- 1 プロジェクト、1 ユーザー、1 分あたり 3,000 クエリ
- プロジェクトごとに 1 分あたり 3,000 件のクエリ
- プロジェクトごとに 1 日あたり 150,000 クエリ
1 日あたりの API オペレーション制限
1 日あたりの API 使用量上限は、Google Cloud プロジェクトごとに行われた API オペレーションの数に基づきます。
1 つのクエリまたはレポートは、SearchAds360Service.SearchStream でストリーミングされる結果や、SearchAds360Service.Search 呼び出しからページングされるかどうかにかかわらず、1 つのオペレーションとしてカウントされます。詳細
オペレーション数のカウント方法の例については、以下の表をご覧ください。
| API リクエスト | 1 日の上限にカウントされるオペレーション |
|---|---|
オペレーション: Searchカウント: 53 広告グループ
サービス: |
1 |
オペレーション: SearchStreamカウント: 45 個のキャンペーン
サービス: |
1 |
これらの上限に違反するリクエストは、RESOURCE_EXHAUSTED というエラーで拒否されます。
検索リクエスト
Search リクエストまたは SearchStream リクエストは、ユーザーの 1 日あたりのオペレーション割り当てに対して 1 オペレーションとしてカウントされます。1 つの SearchStream リクエストは、バッチの数に関係なく 1 つの API オペレーションとしてカウントされます。
gRPC の制限
すべての Search Ads 360 Reporting API クライアント ライブラリは、リクエストとレスポンスの生成に gRPC を使用します。デフォルトでは、gRPC のメッセージ サイズは 4 MB です。
レスポンスはこの上限を超えないようにしてください。たとえば、多数のフィールドを含む検索リクエストでは、サイズが 4 MB を超えるレスポンスが生成される場合があります。この制限を回避するには、選択されるフィールドの数を減らすか、ページサイズを小さくするか、ストリーミングを使用します。
この制限に違反するリクエストでは、SearchAds360Error は生成されませんが、429 Resource Exhausted gRPC エラーが生成されます。gRPC エラーコードとメッセージのリストをご覧ください。
ページ分けリクエスト
ページ分けされたリクエスト（有効な next_page_token を含むリクエストなど）は、ユーザーの 1 日あたりのオペレーション割り当てにカウントされません。ただし、期限切れまたは無効なページトークンを含むページ設定リクエストでは例外が生成され、1 日あたりのオペレーション割り当てにカウントされます。
検索リクエストなど、ページ分割されたリクエストも Page size cannot exceed 10,000 rows 制限の対象となり、この制限に違反すると拒否され、次のエラーが発生します。INVALID_PAGE_SIZE
pagination について詳しくは、結果のページングをご覧ください。
API 例外を返すリクエスト
SearchAds360Failure で拒否されたリクエストも、ユーザーの 1 日あたりのオペレーション割り当てにカウントされます。
ネットワーク レベルのエラーなどにより、失敗しても SearchAds360Failure を返さないリクエストは、サービスに到達しないため、ユーザーの 1 日あたりのオペレーション割り当てにカウントされません。ネットワーク接続障害がその一例です。
その他の種類の制限
オペレーションのリストなどの繰り返しフィールドに含まれるアイテムが多すぎると、REQUEST_SIZE_LIMIT_EXCEEDED というエラーが発生する可能性があります。同じエラー メッセージは、他の問題が原因で発生することもあります。
検索広告 360 のクエリ言語でクエリを実行する場合、IN 句内のアイテムの最大数は 20,000 です。この上限を超えると、FILTER_HAS_TOO_MANY_VALUES エラーが返されます。