Google Ads API では、1 つの変換リクエストで送信できるオペレーションの数など、API オペレーションに上限が設けられています。次の表は、注意すべき重要な上限と割り当てをまとめたものです。
リクエストの種類、制限、エラーコード | |||
---|---|---|---|
ページ分けされたリクエスト | ページあたり 10,000 行 |
INVALID_PAGE_SIZE
|
|
ベーシック アクセスを使用したオペレーション | 1 日あたり 15,000 回の API オペレーション |
RESOURCE_EXHAUSTED
|
|
変更リクエスト | リクエストあたり 10,000 オペレーション |
TOO_MANY_MUTATE_OPERATIONS
|
|
サービス リクエストの計画 | 1 QPS |
RESOURCE_EXHAUSTED
|
|
コンバージョン アップロード サービスのリクエスト | リクエストごとに 2,000 件のコンバージョン |
TOO_MANY_CONVERSIONS_IN_REQUEST
|
|
請求とアカウントの予算サービス リクエスト | 変更リクエストあたり 1 オペレーション |
TOO_MANY_MUTATE_OPERATIONS
|
1 日あたりの API オペレーション制限
1 日あたりの API 使用量上限は、開発者トークンごとに行われた API オペレーションの数に基づきます。API オペレーション数は、get リクエスト数と mutate オペレーション数の合計です。1 日あたりの API オペレーション制限は、開発者トークンのアクセス権によって異なります。各アクセスレベルの具体的な API オペレーション制限については、アクセスレベルと利用規定ガイドをご覧ください。
これらの上限に違反するリクエストは、RESOURCE_EXHAUSTED
というエラーで拒否されます。
gRPC の制限
すべての Google Ads API クライアント ライブラリは、リクエストとレスポンスの生成に gRPC を使用します。デフォルトでは、gRPC のメッセージ サイズは 4 MB ですが、クライアント ライブラリでは効率を高めるために最大メッセージ サイズが 64 MB に設定されています。
レスポンスはこの上限を超えないようにしてください。たとえば、多くのフィールドを含む検索リクエストの場合、64 MB を超えるサイズのレスポンスが生成される場合があります。この制限を回避するには、選択されるフィールドの数を減らすか、ページサイズを小さくするか、ストリーミングを使用します。変更の場合は、リクエストごとに送信するオペレーションの数を減らします。
この制限に違反するリクエストでは、GoogleAdsError
は生成されませんが、429 Resource Exhausted
gRPC エラーが生成されます。gRPC エラーコードとメッセージのリストをご覧ください。
mutate リクエスト
変更リクエストには、ユーザーの 1 日あたりのオペレーション割り当てにカウントされるほか、リクエストあたり 10,000 件を超えるオペレーションを含めることができません。
この制限に違反するリクエストは、TOO_MANY_MUTATE_OPERATIONS
というエラーで拒否されます。
特定のサービスとリクエスト タイプに関するその他の制限と考慮事項については、下記をご覧ください。
検索リクエスト
Search
リクエストまたは SearchStream
リクエストは、ユーザーの 1 日あたりのオペレーション割り当てに対して 1 オペレーションとしてカウントされます。1 つの SearchStream
リクエストは、バッチの数に関係なく 1 つの API オペレーションとしてカウントされます。
ページ分けリクエスト
ページ分けされたリクエスト(有効な next_page_token
を含むリクエストなど)は、ユーザーの 1 日あたりのオペレーション割り当てにカウントされません。ただし、期限切れまたは無効なページトークンを含むページ設定リクエストでは例外が生成され、1 日あたりのオペレーション割り当てにカウントされます。
検索リクエストなど、ページ分割されたリクエストも Page size cannot exceed 10,000 rows
制限の対象となり、この制限に違反すると拒否され、次のエラーが発生します。INVALID_PAGE_SIZE
pagination について詳しくは、結果のページングをご覧ください。
その他の種類のリクエスト
Get
、Mutate
、Search
、SearchStream
以外のリクエストは、ユーザーの 1 日あたりのオペレーション割り当てに対して 1 回のオペレーションとしてカウントされます。
そのようなリクエストの例には次のようなものがあります。
BatchJobService.ListMutateJobResults
ConversionUploadService.UploadCallConversions
ConversionUploadService.UploadClickConversions
OfflineUserDataJobService.AddOfflineUserDataJobOperations
OfflineUserDataJobService.CreateOfflineUserDataJob
UserDataService.UploadUserData
API 例外を返すリクエスト
GoogleAdsFailure
で拒否されたリクエストも、ユーザーの 1 日あたりのオペレーション割り当てにカウントされます。
ネットワーク レベルのエラーなどにより、失敗しても GoogleAdsFailure
を返さないリクエストは、サービスに到達しないため、ユーザーの 1 日あたりのオペレーション割り当てにカウントされません。ネットワーク接続障害がその一例です。
プランニング サービス
以下に一覧表示されているプラニング サービス メソッドは複雑で費用がかさむため、他のタイプのリクエストとは別の制限を受けます。
お客様 ID または開発者トークンごとに 1 秒あたり 1 件のリクエストに制限されます。
KeywordPlanService.GetKeywordPlan
KeywordPlanService.GenerateHistoricalMetrics
KeywordPlanService.GenerateForecastMetrics
これらの制限に違反するリクエストは、
RESOURCE_EXHAUSTED
というエラーで拒否されます。1 QPS は 60 秒あたり 60 リクエストとして計算されます。
キーワード プランを作成する際は、これらの制限事項にご注意ください。
キーワード プラン オブジェクト | 最大数 |
---|---|
アカウントあたり KeywordPlan |
10,000 |
KeywordPlanAdGroup / KeywordPlan |
200 |
KeywordPlanAdGroupKeyword / KeywordPlan |
10,000 |
KeywordPlanCampaignKeyword (除外キーワード) |
1,000 |
KeywordPlanCampaign / KeywordPlan |
1 |
コンバージョン アップロード サービス
1 回のリクエストあたりの通話コンバージョンまたはクリック コンバージョンは 2,000 件まで:
これらの上限に違反するリクエストは、
TOO_MANY_CONVERSIONS_IN_REQUEST
というエラーで拒否されます。
コンバージョン調整のアップロード サービス
コンバージョンの調整はリクエストごとに 2,000 回まで:
これらの上限に違反するリクエストは、
TOO_MANY_ADJUSTMENTS_IN_REQUEST
というエラーで拒否されます。
お支払いとアカウント予算サービス
mutate リクエストは、毎月の請求書発行が設定されたアカウントに対してのみ行うことができます。
この制限に違反するリクエストは、
MUTATE_NOT_ALLOWED
というエラーで拒否されます。変更リクエストに使用できるオペレーションは 1 個のみです。
この制限に違反するリクエストは、
TOO_MANY_MUTATE_OPERATIONS
というエラーで拒否されます。同じアカウントに対する予算オーダーの変更は、少なくとも 12 時間待つ必要があります。12 時間が経過する前に変更を加えると、Google 広告のアカウント担当者しか解決できない回復不能なエラーが発生する可能性があります。
お客様アカウントへの招待
CustomerUserAccessService
を使用して、既存のクライアント アカウントに新規ユーザーを招待できます。この機能は招待メールを他のユーザーに送信するため、悪用される可能性があり、そのために動作に制限があります。
ユーザーは、同じクライアント アカウントに対して保留中の招待を複数受け取ることはできません。すでに保留中の招待があるユーザーに招待状を送信するためにその後のリクエストを行うと、
ACCESS_INVITATION_ERROR_EMAIL_ADDRESS_ALREADY_HAS_PENDING_INVITATION
というエラーが返されます。クライアント アカウントで同時に保留にできる招待状は 70 件までです。 この値を超過するリクエストが送信されると、
ACCESS_INVITATION_ERROR_PENDING_INVITATIONS_LIMIT_EXCEEDED
というエラーが返されます。
ユーザーデータ
ユーザーデータは、UserDataService
と OfflineUserDataJobService
で管理されます。UserData
の作成/削除オペレーションでは、user_identifiers
の各セットは 1 人のユーザーに固有である必要があります。
これを実施するため、UserData
セットに 20 個を超える user_identifiers
があると、OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS
エラーまたは UserDataError.TOO_MANY_USER_IDENTIFIERS
エラーが返されます。
その他の種類の制限
オペレーションのリストなどの繰り返しフィールドに含まれるアイテムが多すぎると、REQUEST_SIZE_LIMIT_EXCEEDED
というエラーが発生する可能性があります。同じエラー メッセージは、他の問題が原因で発生することもあります。
この制限に遭遇し、繰り返しフィールドを使用するリクエストを行っている場合は、変更リクエストにオペレーションのリストをデプロイして、繰り返しフィールドのアイテム数を減らしてみてください。
GAQL クエリを作成する場合、IN
句内のアイテムの最大数は 20,000 です。この上限を超えると、FILTER_HAS_TOO_MANY_VALUES
エラーが返されます。