리소스 메타데이터

SearchAds360FieldService를 사용하여 SearchAds360Service SearchSearchStream 메서드에서 사용할 수 있는 리소스, 리소스 필드, 세분화 키, 측정항목의 카탈로그를 동적으로 요청할 수 있습니다. 카탈로그는 Search Ads 360 Reporting API 클라이언트가 Search Ads 360 쿼리 언어 문을 검증하고 생성하는 데 사용할 수 있는 메타데이터를 제공합니다.

샘플 HTTP 요청 및 응답

요청은 다음 URL의 Search Ads 360 Reporting API 서버에 대한 HTTP GET로 구성됩니다.

https://searchads360.googleapis.com/v0/searchAds360Fields/{resource_or_field}

다음은 요청의 예와 ad_group 리소스에 대해 SearchAds360FieldService에서 반환된 응답입니다.

요청

https://searchads360.googleapis.com/v0/searchAds360Fields/ad_group

응답

{
 
"resourceName": "searchAds360Fields/ad_group",
 
"name": "ad_group",
 
"category": "RESOURCE",
 
"selectable": false,
 
"filterable": false,
 
"sortable": false,
 
"selectableWith": [
   
"campaign",
   
"customer",
   
"metrics.average_cpc",
   
"segments.device",
   
...
 
],
 
"attributeResources": [
   
"customer",
   
"campaign"
 
],

 
"metrics": [
   
"metrics.conversions",
   
"metrics.search_budget_lost_impression_share",
   
"metrics.average_cost",
   
"metrics.clicks",
   
...
 
],
 
"segments": [
   
"segments.date",
   
"segments.ad_network_type",
   
"segments.device",
   
...
 
]
}

이 예시에서 중요한 배열은 다음과 같습니다.

attributeResources
FROM 절의 리소스에 암시적으로 조인할 수 있는 리소스입니다.
metrics
FROM 절에서 리소스와 함께 선택할 수 있는 측정항목입니다. categoryRESOURCE인 필드에만 채워집니다.
segments
FROM 절의 리소스와 함께 선택할 수 있는 세그먼트 키입니다. 이러한 측정항목은 쿼리에 지정된 측정항목을 분류합니다. categoryRESOURCE인 필드에만 채워집니다.
selectableWith
FROM 절에 있지 않을 때 지정된 필드와 함께 선택할 수 있는 필드입니다. 이 속성은 FROM 절의 리소스에 포함되지 않은 쿼리에서 선택할 수 있는 리소스 또는 세그먼트를 식별할 때만 관련이 있습니다. 예를 들어 ad_group에서 ad_group.idsegments.date를 선택하고 campaign의 속성을 포함하려는 경우 기존 segments.date 필드와 함께 선택되므로 segments.date가 캠페인의 selectableWith 속성에 있는지 확인해야 합니다.

메타데이터 세부정보

다음 수준에서 SearchAds360FieldService를 사용하여 카탈로그를 요청할 수 있습니다.

리소스
예를 들어 searchAds360Fields/campaign입니다.
리소스의 필드
예를 들어 searchAds360Fields/campaign.name입니다.
분류 필드
예를 들어 searchAds360Fields/segments.ad_network_type입니다.
측정항목
예를 들어 searchAds360Fields/metrics.clicks입니다.

쿼리를 사용하여 필드 세부정보 가져오기

다음 주소로 쿼리를 전송하여 필드 세부정보를 가져올 수 있습니다.

https://searchads360.googleapis.com/v0/searchAds360Fields:search

예 1: 정규 표현식 사용

SELECT
  name
,
  category
,
  selectable
,
  filterable
,
  sortable
,
  selectable_with
,
  data_type
,
  is_repeated
WHERE name LIKE 'ad_group.%'"

예 2: 특정 필드, 측정항목 또는 세그먼트 쿼리

SELECT
  name
,
  category
,
  selectable
,
  filterable
,
  sortable
,
  selectable_with
,
  data_type
,
  is_repeated
WHERE
  name
IN (
   
"ad_group.id",
   
"ad_group.name",
   
"segments.date",
   
"customer.id",
   
"customer.manager",
   
"metrics.clicks"
 
)