Search Ads 360 Reporting API는 최신 플랫폼을 기반으로 하며 다양한 새 개념을 도입합니다. 이에 대해서는 다음 섹션에서 설명합니다.
리소스
리소스 객체가 보고서 유형을 대체합니다. 이제 사전 정의된 보고서 유형을 요청하는 대신 새로운 SQL과 유사한 쿼리 언어를 사용하여 모든 리소스를 쿼리할 수 있습니다. 자세한 내용은 Search Ads 360 Reporting API 구조를 참고하세요.
검색 보고
새 API에는 검색 자체 서비스가 있습니다. 검색 서비스는 기존 보고서 서비스를 대체합니다. 모든 쿼리는 보고 데이터 및 측정항목을 검색하고 검색하는 두 가지 메서드인 SearchStream 및 Search를 제공하는 SearchAds360Service를 거칩니다. 두 검색 메서드 모두 검색어와 일치하는 모든 SearchAds360Row 객체를 반환합니다. 자세한 내용은 검색 보고서 만들기를 참고하세요.
리소스 메타데이터
SearchAds360FieldService를 사용하면 SearchAds360Service 검색 메서드에서 사용할 수 있는 리소스, 리소스 필드, 세분화 키, 측정항목의 카탈로그를 동적으로 요청할 수 있습니다. 자세한 내용은 리소스 메타데이터 검색을 참조하세요.
필드 이름
API는 점 표기법으로 구분된 중첩된 필드 이름을 도입합니다. 예를 들면 campaign.id 및 ad_group.id입니다. 더 중첩할 수도 있습니다(예: ad_group.campaign.id). 자세한 내용은 Search Ads 360 Reporting API 구조를 참고하세요.
이전 Search Ads 360 API의 보고는 유사한 개념에 대해 서로 다른 항목의 별도 필드를 기반으로 합니다. 예를 들어 campaign 및 adgroup 보고서에는 별도의 campaignId 필드가 포함됩니다.
쿼리 언어
이 API에서는 Search Ads 360 쿼리 언어를 도입합니다. 이는 비즈니스에 가장 적합한 특정 보고 데이터를 검색하는 쿼리를 정의할 수 있는 유연한 SQL과 유사한 언어입니다. 자세한 내용은 Search Ads 360 쿼리 언어를 참조하세요.
요청 가져오기
새 API에서 검색에는 자체 서비스 (SearchAds360Service)가 있지만 각 항목의 특정 서비스에는 여전히 GET 요청이 있습니다. 예를 들어 CustomColumnService에서 맞춤 열 정보를 가져올 수 있습니다. 자세한 내용은
Search Ads 360 Reporting API의 형식 변경사항을 참고하세요.
맞춤 열
새 Search Ads 360에서는 수식 열과 맞춤 전환을 맞춤 열이라고 합니다. 맞춤 열에 대해 자세히 알아보기 새 CustomColumnService는 맞춤 열을 사용 설정합니다. 필요한 권한이 있는 경우 계정 트리의 모든 계정에서 소유한 CustomColumn 리소스를 요청할 수 있습니다.
계정 관리
새 Search Ads 360에서는 계정의 계층 구조가 관리자 계정, 하위 관리자 계정, 고객 계정으로 구성됩니다. 관리자 계정은 이전 Search Ads 360의 대행사 계정을, 하위 관리자 계정은 광고주 계정을 나타냅니다. 자세한 내용은 Search Ads 360 관리자 계정에 대한 정보를 참고하세요.
계정 트리를 쿼리한 다음 데이터를 보고할 각 계정에 대한 요청을 제출할 수 있습니다.
계정 계층 구조가 변경됨에 따라 광고주/대행사 개념과 관련된 필드는 가능한 경우 기능적 동등성을 제공하기 위해 적절한 대안으로 대체되었습니다. 영향을 받는 필드와 대체 필드의 목록은 필드 매핑을 참고하세요.
로그인 고객 ID 헤더
login-customer-id는 관리자 계정을 사용하여 하위 관리자 계정 또는 고객 계정에 액세스할 때 필요한 새로운 헤더입니다. 자세한 내용은 로그인 고객 ID 헤더를 참고하세요.
버전 관리
Search Ads 360 Reporting API는 시맨틱 버전 관리를 사용합니다.
vMAJOR_MINOR 형식의 메이저 버전과 마이너 버전이 있습니다. 자세한 내용은 버전 관리를 참고하세요.