리소스 메타데이터

SearchAds360FieldService를 사용할 수 있습니다. 리소스, 리소스 필드, 애플리케이션에 대한 카탈로그를 SearchAds360Service에서 사용할 수 있는 세분화 키 및 측정항목 Search 및 SearchStream 메서드 카탈로그는 Search Ads 360의 유효성 검사 및 구성을 위해 Search Ads 360 Reporting API 클라이언트에서 사용 쿼리 언어 문

샘플 HTTP 요청 및 응답

요청은 다음 위치에서 Search Ads 360 Reporting API 서버에 대한 HTTP GET로 구성됩니다. 다음 URL에서 찾을 수 있습니다.

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의 리소스와 함께 선택할 수 있는 측정항목 절. category가 RESOURCE인 필드에만 채워집니다.

segments

FROM 절에서 리소스로 선택할 수 있는 세그먼트 키입니다. 이러한 항목은 검색어에 지정된 측정항목을 분류합니다. 필드에만 입력됨 여기서 category는 RESOURCE입니다.

selectableWith

FROM에 있지 않은 경우 특정 필드와 함께 선택할 수 있는 필드 절. 이 속성은 리소스나 세그먼트를 식별할 때만 관련이 있습니다. 선택할 수 있는 FROM 절에 있습니다. 예를 들어 ad_group.id를 선택하는 경우 및 ad_group의 segments.date를 가져오고, campaign이면 segments.date가 selectableWith 속성이 있어야 합니다. 기존 segments.date 필드가 있을 수 있습니다.

메타데이터 세부정보

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

리소스

예를 들면 searchAds360Fields/campaign입니다.

리소스 필드

예를 들면 searchAds360Fields/campaign.name입니다.

세분화 필드

예를 들면 searchAds360Fields/segments.ad_network_type입니다.

측정항목

예를 들면 searchAds360Fields/metrics.clicks입니다.

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

It is possible to get field details by sending a query to

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"
  )