Search Ads 360 Reporting API では、すべてのユーザーが最適なシステム パフォーマンスを得られるよう、API オペレーションに制限が設けられています。
料金
Search Ads 360 Reporting API の使用は、検索広告 360 の全体的な料金に含まれています。API の使用に追加料金はかかりません。
クエリに関する上限
Search メソッドまたは SearchStream メソッドを通じて実行されるクエリ オペレーションには、次の制限が適用されます。
- 1 ユーザー、1 プロジェクト、1 分あたり 3,000 クエリ
- 1 プロジェクト、1 分あたり 3,000 クエリ
- 1 プロジェクト、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
エラーが返されます。