객체 검색

GoogleAdsService는 통합 객체입니다. 검색 및 보고 서비스입니다. 서비스에는 다음과 같은 메서드가 있습니다.

  • 객체의 특정 속성을 검색합니다.
  • 기간을 기준으로 객체의 성능 측정항목을 가져옵니다.
  • 속성에 따라 객체의 순서를 지정합니다.
  • 조건을 사용하여 응답에서 반환되기를 원하는 객체를 나타냅니다.
  • 반환되는 객체의 수를 제한합니다.

GoogleAdsService는 다음과 같은 형식으로 결과를 반환할 수 있습니다. 두 가지 방법:

  • GoogleAdsService.SearchStream 드림 단일 스트리밍 응답으로 모든 행을 반환하며 대규모 (10,000행 초과) 결과 집합 이 방법이 더 적합할 수 있습니다. 일괄 애플리케이션이 최대한 빨리 많은 데이터를 다운로드하려는 경우 있습니다.
  • GoogleAdsService.Search이(가) 끊어집니다. 처리할 수 있는 결과 페이지로 변환합니다. 더 클 수 있습니다. 대화형 애플리케이션이 있습니다.

페이징 및 스트리밍 비교에 대해 자세히 알아보세요.

요청하기

검색 메서드에는 SearchGoogleAdsRequest: 구성 다음 속성 중 하나:

  • customer_id
  • 쿼리할 리소스, 속성 및 서비스를 나타내는 query Google Ads 쿼리 언어 가져올 세그먼트, 측정항목, 제한하기 위해 사용할 조건을 어떤 객체가 반환되는지
  • (GoogleAdsService.Search만 해당) A page_size: 다음 시점에 단일 응답에서 반환할 객체 수를 나타냅니다. (페이징 사용)
  • (GoogleAdsService.Search만 해당) 를 사용할 때 결과의 다음 배치를 검색하는 선택적 page_token 페이징:

Google Ads 쿼리 언어에 대한 자세한 내용은 Google Ads 쿼리 언어 가이드를 참조하세요.

대답 처리

GoogleAdsServiceGoogleAdsRow 객체.

GoogleAdsRow는 쿼리에서 반환된 객체를 나타내며 SELECT 절. SELECT 절에 포함되지 않은 속성은 응답의 GoogleAdsRow 객체에 채워집니다.

예를 들어 ad_group_criterionstatus 속성이 있지만 행의 ad_group_criterion 속성에 있는 status 필드가 SELECT 절이 포함되지 않은 쿼리에 대한 응답 ad_group_criterion.status입니다. 마찬가지로 행의 campaign 속성은 다음과 같습니다. SELECT 절에 campaign 리소스

GoogleAdsRow은(는) 다른 행에서 서로 다른 속성과 측정항목을 가질 수 있습니다. 동일한 결과 집합에 있는 경우 행을 보기 좋게 표시하는 대신 테이블의 고정 행입니다.

UNKNOWN enum 유형

UNKNOWN 유형으로 반환되는 리소스는 다음에서 완전히 지원되지 않습니다. 확인할 수 있습니다 이러한 리소스는 다른 Google Cloud 도구를 통해 Google Ads UI와 같은 인프라를 관리할 수 있습니다 리소스에 UNKNOWN 형식이지만 API를 통해 리소스를 변경할 수는 없습니다. UI에 도입된 새 캠페인 또는 광고를 예로 들 수 있지만 는 쿼리하는 API 버전에서 지원되지 않습니다.

이와 관련해 다음과 같이 고려해야 할 사항이 있습니다.

  • UNKNOWN 유형의 리소스는 나중에 지원되거나 UNKNOWN 상태를 유지할 수 있습니다. 무기한으로 유지됩니다.
  • UNKNOWN 유형의 새 객체는 언제든지 나타날 수 있습니다. 이러한 객체는 enum 값이 이미 있으므로 이전 버전과 호환됩니다. 리소스 이러한 변경사항이 제공되는 즉시 도입되므로 정확하게 볼 수 있습니다. UNKNOWN 리소스는 다음과 같은 이유로 표시될 수 있습니다. 새 활동이 다른 인터페이스를 통해, 또는 리소스가 더 이상 지원되지 않습니다.
  • 리소스 UNKNOWN개에 다음과 같은 세부 측정항목이 연결될 수 있습니다. 쿼리 가능합니다
  • UNKNOWN 리소스는 일반적으로 Google Ads UI에 전체가 표시됩니다.
  • UNKNOWN 리소스는 일반적으로 변경할 수 없습니다.

세분화

응답에는 각 조합에 대해 GoogleAdsRow 하나의 있습니다.

  • FROM 절에 지정된 기본 리소스의 인스턴스
  • 선택된 각 segment 필드의 값

예를 들어 FROM campaign를 선택하고 SELECT 절의 segments.ad_network_typesegments.date는 다음 각 조합에 대해 하나의 행을 포함합니다.

  • campaign
  • segments.ad_network_type
  • segments.date

결과는 기본 리소스의 인스턴스가 아닌 기본 리소스의 각 인스턴스별로 암시적으로 분할됩니다. 선택된 개별 필드의 값입니다. 예를 들면 다음과 같습니다.

SELECT campaign.status, metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_14_DAYS

이렇게 하면 캠페인당 하나의 행이 표시되며, campaign.status 필드