API の制限と割り当て

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 回のオペレーションとしてカウントされます。

そのようなリクエストの例には次のようなものがあります。

API 例外を返すリクエスト

GoogleAdsFailure で拒否されたリクエストも、ユーザーの 1 日あたりのオペレーション割り当てにカウントされます。

ネットワーク レベルのエラーなどにより、失敗しても GoogleAdsFailure を返さないリクエストは、サービスに到達しないため、ユーザーの 1 日あたりのオペレーション割り当てにカウントされません。ネットワーク接続障害がその一例です。

プランニング サービス

以下に一覧表示されているプラニング サービス メソッドは複雑で費用がかさむため、他のタイプのリクエストとは別の制限を受けます。

キーワード プランを作成する際は、これらの制限事項にご注意ください。

キーワード プラン オブジェクト 最大数
アカウントあたり KeywordPlan 10,000
KeywordPlanAdGroup / KeywordPlan 200
KeywordPlanAdGroupKeyword / KeywordPlan 10,000
KeywordPlanCampaignKeyword（除外キーワード） 1,000
KeywordPlanCampaign / KeywordPlan 1

コンバージョン アップロード サービス

コンバージョン調整のアップロード サービス

お支払いとアカウント予算サービス

  • 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 エラーが返されます。

前へ
概要
次へ
システム制限