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 형식으로 지정된 주 버전과 부 버전이 있습니다. 자세한 내용은 버전 관리를 참조하세요.