Google Ads API 리소스 사용 정책 업데이트

2024년 5월 1일 수요일

변경되는 사항

API 리소스를 과도하게 사용하는 GoogleAdsService.Search 및 GoogleAdsService.SearchStream 쿼리 패턴을 제한하기 위해 Google Ads API 리소스 사용 정책을 업데이트하고 있습니다. 특정 쿼리 패턴이 제한되면 다른 서비스, 메서드, 쿼리 패턴은 영향을 받지 않고 계속 작동합니다.

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 오류를 처리합니다.
  • 하나 이상의 보고 쿼리 패턴이 제한되는 경우 쿼리 패턴을 검토하고 수정해야 합니다. 쿼리 성능을 개선하는 방법은 다음과 같습니다.
    • 쿼리를 실행하는 빈도를 줄입니다.
    • 비용이 적게 드는 쿼리 패턴 또는 뷰를 사용합니다.

쿼리 최적화에 대해 자세히 알아보려면 데이터 효율성 관리를 참조하세요.

  • [선택사항] 새 query_resource_consumption 측정항목을 모니터링 시스템에 통합하여 비용이 많이 드는 새 쿼리를 감지하고 처리합니다.

지원을 받는 방법

이번 변경사항에 대해 궁금한 점이 있거나 특정 쿼리 패턴을 최적화하는 데 도움이 필요하면 Google Ads API 지원 페이지에서 옵션을 확인하세요.

- 데이비드 스티븐스, Google Ads API 제품 관리자

라벨: google-ads-api