GoogleAdsService
는 통합 객체입니다.
검색 및 보고 서비스입니다. 서비스에는 다음과 같은 메서드가 있습니다.
- 객체의 특정 속성을 검색합니다.
- 기간을 기준으로 객체의 성능 측정항목을 가져옵니다.
- 속성에 따라 객체의 순서를 지정합니다.
- 조건을 사용하여 응답에서 반환되기를 원하는 객체를 나타냅니다.
- 반환되는 객체의 수를 제한합니다.
GoogleAdsService
는 다음과 같은 형식으로 결과를 반환할 수 있습니다.
두 가지 방법:
GoogleAdsService.SearchStream
드림 단일 스트리밍 응답으로 모든 행을 반환하며 대규모 (10,000행 초과) 결과 집합 이 방법이 더 적합할 수 있습니다. 일괄 애플리케이션이 최대한 빨리 많은 데이터를 다운로드하려는 경우 있습니다.GoogleAdsService.Search
이(가) 끊어집니다. 처리할 수 있는 결과 페이지로 변환합니다. 더 클 수 있습니다. 대화형 애플리케이션이 있습니다.
페이징 및 스트리밍 비교에 대해 자세히 알아보세요.
요청하기
검색 메서드에는
SearchGoogleAdsRequest
: 구성
다음 속성 중 하나:
customer_id
- 쿼리할 리소스, 속성 및 서비스를 나타내는
query
Google Ads 쿼리 언어 가져올 세그먼트, 측정항목, 제한하기 위해 사용할 조건을 어떤 객체가 반환되는지 - (
GoogleAdsService.Search
만 해당) Apage_size
: 다음 시점에 단일 응답에서 반환할 객체 수를 나타냅니다. (페이징 사용) - (
GoogleAdsService.Search
만 해당) 를 사용할 때 결과의 다음 배치를 검색하는 선택적page_token
페이징:
Google Ads 쿼리 언어에 대한 자세한 내용은 Google Ads 쿼리 언어 가이드를 참조하세요.
대답 처리
GoogleAdsService
는
GoogleAdsRow
객체.
각 GoogleAdsRow
는 쿼리에서 반환된 객체를 나타내며
SELECT
절. SELECT
절에 포함되지 않은 속성은
응답의 GoogleAdsRow
객체에 채워집니다.
예를 들어 ad_group_criterion
에 status
속성이 있지만
행의 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_type
및 segments.date
는
다음 각 조합에 대해 하나의 행을 포함합니다.
campaign
segments.ad_network_type
segments.date
결과는 기본 리소스의 인스턴스가 아닌 기본 리소스의 각 인스턴스별로 암시적으로 분할됩니다. 선택된 개별 필드의 값입니다. 예를 들면 다음과 같습니다.
SELECT campaign.status, metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_14_DAYS
이렇게 하면 캠페인당 하나의 행이 표시되며,
campaign.status
필드