API の制限と割り当て

Google Ads API では、1 回の mutate リクエストで送信できるオペレーションの数など、API オペレーションの数に制限があります。次の表に、注意すべき重要な上限と割り当てを示します。

リクエストの種類、制限、エラーコード
ベーシック アクセスでの操作15,000 API オペレーション/日RESOURCE_EXHAUSTED
mutate リクエスト10,000 オペレーション/リクエストTOO_MANY_MUTATE_OPERATIONS
プランニング サービス リクエスト1 QPSRESOURCE_EXHAUSTED
コンバージョン アップロード サービス リクエスト2,000 コンバージョン/リクエストTOO_MANY_CONVERSIONS_IN_REQUEST
お支払い情報とアカウント予算に関するサービス リクエスト1 オペレーション/mutate リクエスト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 を超えるレスポンスを生成することがあります。この上限を回避するには、選択したフィールドの数を減らすか、ストリーミングを使用します。mutate の場合は、リクエストごとに送信するオペレーションを少なくします。

この制限に違反するリクエストは GoogleAdsError を生成しませんが、429 Resource Exhausted gRPC エラーを生成します。gRPC エラーコードとメッセージのリストをご覧ください。

mutate リクエスト

mutate リクエストは、1 日あたりのオペレーション割り当てに対してカウントされるだけでなく、1 リクエストあたり 10,000 オペレーションを超えることはできません。

この制限に違反するリクエストは、TOO_MANY_MUTATE_OPERATIONS というエラーで拒否されます。

特定のサービスとリクエスト タイプに関する追加の上限と考慮事項は次のとおりです。

リクエストを検索

Search リクエストまたは SearchStream リクエストは、ユーザーの 1 日あたりのオペレーション割り当てに対して 1 つのオペレーションとしてカウントされます。1 つの SearchStream リクエストは、バッチの数に関係なく 1 つの API オペレーションとしてカウントされます。

ページ分けリクエスト

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

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

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

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

このようなリクエストの例をいくつか示します。

API 例外を返すリクエスト

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

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

キーワード プランニング サービス

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

キーワード プランを作成する際は、次の上限にご注意ください。

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

オーディエンス分析サービス

AudienceInsightsService メソッド内の次のメソッドには、特定の割り当て上限が適用されます。

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

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

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

  • mutate リクエストは、毎月の請求書発行が設定されたアカウントに対してのみ行うことができます。

    この制限に違反するリクエストは、MUTATE_NOT_ALLOWED というエラーで拒否されます。

  • mutate リクエストに対して許可されるオペレーションは 1 回だけです。

    この制限に違反するリクエストは、TOO_MANY_MUTATE_OPERATIONS というエラーで拒否されます。

  • 同じアカウントに対する予算オーダーの変更は、最低 12 時間待ってから行う必要があります。12 時間が経過する前に変更を加えると、Google 広告のアカウント担当者しか解決できない回復不能なエラーが発生する可能性があります。

お客様のアカウントへの招待

新規ユーザーは、CustomerUserAccessService を使用して既存のクライアント アカウントに招待できます。この機能は他のユーザーに招待メールを送信するため、不正使用される可能性があるため、動作に制限があります。

ユーザーデータ

ユーザーデータは UserDataService と OfflineUserDataJobService で管理されます。特定の作成または削除 UserData オペレーションでは、各 user_identifiers セットが単一のユーザーに固有である必要があります。

これを適用するため、UserData セットに 20 個を超える user_identifiers が含まれていると、OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS エラーまたは UserDataError.TOO_MANY_USER_IDENTIFIERS エラーが返されます。

オペレーションの数に関係なく、最大 100,000 個のユーザー ID を使用できます。

その他の種類の制限

リクエストに含まれるアイテムが多すぎる繰り返しフィールド（例: オペレーションのリスト）では、REQUEST_SIZE_LIMIT_EXCEEDED エラーが発生する可能性があります。この同じエラー メッセージは他の問題が原因である可能性もあります。

繰り返しフィールドを使用するリクエストを行って、この制限に達成した場合は、mutate リクエストにオペレーションのリストを配置することによって繰り返しフィールドのアイテム数を減らしてみましょう。

GAQL クエリを実行する場合、IN 句内のアイテムの最大数は 20,000 です。この上限を超えると、FILTER_HAS_TOO_MANY_VALUES エラーが返されます。

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