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 日あたりのクエリ数: 150,000 件
1 日あたりの API オペレーション制限
1 日あたりの API 使用制限は、Google Cloud プロジェクトごとに行われた API オペレーションの数に基づいています。
結果が SearchAds360Service.SearchStream を介してストリーミングされるか、SearchAds360Service.Search 呼び出しからページングされるかに関係なく、1 つのクエリまたはレポートは 1 つのオペレーションとしてカウントされます。詳細
オペレーション数のカウント方法の例については、以下の表をご覧ください。
| API リクエスト | 1 日あたりの上限にカウントされるオペレーション |
|---|---|
オペレーション: Search
カウント: 53 個の広告グループ サービス: SearchAds360Service
|
1 |
オペレーション: SearchStream
カウント: 45 件のキャンペーン サービス: SearchAds360Service
|
1 |
これらの制限に違反するリクエストは、RESOURCE_EXHAUSTED というエラーで拒否されます。
リクエストを検索
Search リクエストまたは SearchStream リクエストは、ユーザーの 1 日あたりのオペレーション割り当てに対して 1 つのオペレーションとしてカウントされます。SearchStream リクエスト 1 件は、バッチの数に関係なく、1 件の API オペレーションとしてカウントされます。
gRPC の制限
すべての Search Ads 360 Reporting API クライアント ライブラリは、リクエストとレスポンスを生成するために gRPC を使用します。デフォルトでは、gRPC のメッセージ サイズは 4 MB です。
回答はこの上限を超えてはなりません。たとえば、多数のフィールドを含む検索リクエストは、サイズが 4 MB を超えるレスポンスを生成することがあります。この制限を回避するには、選択したフィールドの数を減らすか、ページサイズを小さくするか、ストリーミングを使用します。
この制限に違反するリクエストは SearchAds360Error を生成しませんが、429 Resource Exhausted gRPC エラーを生成します。gRPC エラーコードとメッセージのリストをご覧ください。
ページ分けリクエスト
ページ分けリクエスト（有効な next_page_token を含むリクエストなど）は、ユーザーの 1 日あたりのオペレーション割り当てにカウントされません。ただし、期限切れや無効なページトークンを含む pagination リクエストは例外を生成し、1 日あたりのオペレーション割り当てにカウントされます。
search リクエストなどのページ分けリクエストには、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 エラーが返されます。