리소스 메타데이터

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

샘플 HTTP 요청 및 응답

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

https://googleads.googleapis.com/v16/googleAdsFields/{resource_or_field}

다음은 ad_group 리소스에 대해 GoogleAdsFieldService에서 반환된 응답 다음에 나오는 요청의 예입니다.

요청

https://googleads.googleapis.com/v16/googleAdsFields/ad_group

응답

{
  "resourceName": "googleAdsFields/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에서 ad_group.id 및 segments.date를 선택하고 campaign의 속성을 포함하려면 segments.date가 기존 segments.date 필드와 함께 선택되므로 캠페인의 selectableWith 속성에 있는지 확인해야 합니다.

메타데이터 세부정보

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

리소스
예를 들면 googleAdsFields/campaign입니다.
리소스 필드
예를 들면 googleAdsFields/campaign.name입니다.
세분화 필드
예를 들면 googleAdsFields/segments.ad_network_type입니다.
측정항목
예를 들면 googleAdsFields/metrics.clicks입니다.
이전
객체 검색
다음
통화 구조