객체 검색

목표: 다음을 사용하여 객체와 성능 통계를 검색하는 방법 이해 GoogleAdsService입니다. 보고 개념의 경우 보고 가이드를 참고하세요.

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 쿼리 언어 가이드를 참조하세요.

대답 처리

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 필드