Google Ads API リソース利用ポリシーの更新

2024 年 5 月 1 日（水曜日）

変更内容

Google Ads API のリソース使用ポリシーを更新し、API のリソースを大量に消費する GoogleAdsService.Search と GoogleAdsService.SearchStream のクエリパターンを制限します。特定のクエリパターンがスロットリングされても、他のサービス、メソッド、クエリパターンは影響を受けずに引き続き機能します。

2024 年 6 月 17 日より、制限対象のクエリパターンに限り、リクエストは次のように影響を受けます。

  • API のバージョン v17 以前を使用している場合は、QuotaError.RESOURCE_EXHAUSTED エラーが表示されます。
  • API のバージョン v18 以降を使用している場合は、リソースの過剰な消費が短期間（数分）か長期間かに応じて、QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION または QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION が返されます。

また、費用のかかるレポートを特定してモニタリングできるように、個々のレポートの費用指標も返されます。正常に完了したレポートの費用を確認するには、次のフィールドをご覧ください。

変更の理由を教えてください。

この変更は、API の信頼性と安定性を維持するために行われます。

必要なご対応

2024 年 6 月 17 日までに、アプリケーションを更新して次の操作を行います。

  • GoogleAdsService::Search or GoogleAdsService::SearchStream 呼び出しを行うときに、新しいエラーコードを処理する
    • Google Ads API のバージョン v17 以前を使用している場合は、QuotaError.RESOURCE_EXHAUSTED エラーを処理します。
    • API のバージョン v18 以降を使用している場合は、QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION エラーと QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION エラーを処理します。
  • 1 つ以上のレポートクエリパターンがスロットリングされている場合は、クエリパターンを確認して修正する必要があります。クエリのパフォーマンスを向上させる方法は次のとおりです。
    • クエリの実行頻度を減らす。
    • より低コストのクエリパターンまたはビューを使用します。

クエリの最適化の詳細については、データ効率を管理するをご覧ください。

  • [省略可] 新しい query_resource_consumption 指標をモニタリング システムに組み込んで、新しい高コストのクエリを検出して処理します。

サポートの利用方法

今回の変更についてご不明な点がある場合、または特定のクエリパターンの最適化についてサポートが必要な場合は、Google Ads API のサポートページでオプションをご確認ください。

- David Stevens、Google Ads API プロダクト マネージャー

ラベル: google-ads-api