Google Ads API의 Search 및 SearchStream 응답에 적용될 예정된 변경사항

2025년 7월 1일 화요일

변경사항

작년에 Google Ads API 쿼리의 비용을 측정하는 방법으로 query_resource_consumption 측정항목을 도입했습니다. 하지만 쿼리 결과가 비어 있으면 이 비용이 반환되지 않았습니다.

2025년 8월 4일 주부터 모든 API 버전에서 GoogleAdsService의 Search 및 SearchStream 메서드 동작이 수정되어 쿼리 결과가 비어 있는 경우에도 query_resource_consumption 측정항목과 field_mask 필드가 반환됩니다. 빈 쿼리 결과에 대한 응답은 다음과 같이 변경됩니다.

메서드 이전 대답 새로운 답변
검색
{
    "fieldMask": "..."
}
{
    "fieldMask": "...",
    "query_resource_consumption": 123
}
SearchStream
[]
{
    "fieldMask": "...",
    "queryResourceConsumption": 206
}

어떤 조치를 취해야 하나요?

Search 및 SearchStream 메서드를 사용하여 Google Ads API 보고서를 다운로드하는 경우 애플리케이션이 수정된 응답을 처리할 수 있는지 확인하세요.

궁금한 점이 있거나 도움이 필요한 경우 Google Ads API 지원 페이지에서 옵션을 확인하세요.

계정 정책과 관련하여 궁금한 점이 있으면 Google Ads 제품 지원팀에 문의하세요.

라벨: google-ads-api, reporting