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