API の制限と割り当て

Google Ads API では、API オペレーションの上限が適用されます。たとえば、オペレーションの回数、 1 回の変換リクエストで送信できる値を指定します。次の表は、 知っておくべき重要な上限と割り当てについて 説明します

リクエストの種類、制限、エラーコード
ベーシック アクセスによるオペレーション 15,000 API オペレーション/日 RESOURCE_EXHAUSTED
変更リクエスト 1 リクエストあたり 10,000 件のオペレーション TOO_MANY_MUTATE_OPERATIONS
プランニング サービス リクエスト 1 QPS RESOURCE_EXHAUSTED
コンバージョン アップロード サービス リクエスト 2,000 コンバージョン/リクエスト TOO_MANY_CONVERSIONS_IN_REQUEST
お支払いとアカウント予算に関するサービス リクエスト 1 オペレーション/mutate リクエスト TOO_MANY_MUTATE_OPERATIONS

1 日あたりの API オペレーション制限

1 日あたりの 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 つの SearchStream リクエストは 1 つの API オペレーションとしてカウントされます 常に同じです

ページ分けリクエスト

ページ分けされたリクエスト(有効な next_page_token など)は、ユーザーの 1 日のオペレーション割り当てにはカウントされません。 ただし、期限切れまたは無効なページトークンを含むページネーション リクエストを行うと、 例外が生成され、1 日あたりのオペレーション割り当てにカウントされます。

pagination について詳しくは、結果のページングをご覧ください。

その他のタイプのリクエスト

GetMutateSearchSearchStream 以外のリクエスト は、ユーザーの 1 日のオペレーション割り当てに対して 1 回のオペレーションとしてカウントされます。

このようなリクエストの例として、次のようなものがあります。

API 例外を返すリクエスト

拒否されるリクエストが GoogleAdsFailure は引き続き、 ユーザーごとの 1 日あたりのオペレーション割り当て数を管理できます。

失敗しても結果を返さないリクエスト GoogleAdsFailure(例: ネットワーク レベルでは、ユーザーの 1 日あたりのオペレーション割り当てにはカウントされません。 リクエストが Service に到達しないからです。たとえば ネットワーク接続エラー。

プランニング サービス

費用と複雑さから、プランニング サービス手法の 他のタイプのリクエストとは異なる上限が適用されます。

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

キーワード プランのオブジェクト 最大数
アカウントあたり 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。なぜなら、 他のユーザーに招待メールを送信する機能があり、 悪用されるため、その動作には制限があります。

ユーザーデータ

ユーザーデータは UserDataService および OfflineUserDataJobService。 特定の UserData 作成または削除操作で、 user_identifiers のセット 1 人のユーザーに固有である必要があります

これを実施するには OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS または UserDataError.TOO_MANY_USER_IDENTIFIERS に 20 個を超える user_identifiers があると、エラーが返されます。 UserData が設定されました。

その他の種類の制限

オペレーションのリストなどの繰り返しフィールドで、 次のエラーが発生する可能性があります。 REQUEST_SIZE_LIMIT_EXCEEDED。 この同じエラー メッセージは、他の問題が原因である可能性もあります。

この制限に達し、繰り返し使用を使用するリクエストを行う場合、 繰り返しフィールドのアイテム数を減らしてみてください。 変更リクエストのオペレーションのリスト。

GAQL クエリを作成する際のアイテムの最大数は、 IN 句あたり 20,000 文字です。この上限を超えると FILTER_HAS_TOO_MANY_VALUES エラーが返されます。