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 オペレーションの数に基づきます。
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 日あたりのオペレーション割り当てにカウントされません。ただし、期限切れや無効なページトークンを含む pagination リクエストは例外を生成し、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 エラーが返されます。