GetGoogleAdsReport 2025.5.31.15¶
번들¶
com.snowflake.openflow.runtime | runtime-google-ads-nar
설명¶
Google Ads Reporting API 와 상호 작용할 수 있는 프로세서입니다. 기본적으로 하루에 한 번 데이터를 가져옵니다
입력 요구 사항¶
FORBIDDEN
민감한 동적 속성 지원¶
false
속성¶
속성 |
설명 |
|---|---|
클라이언트 계정 ID |
보고서를 가져와야 하는 Google Ads 계정의 ID |
GCP Credentials Service |
Google Cloud Platform 자격 증명을 얻는 데 사용되는 Controller Service입니다. |
Google Ads 리소스 이름 |
쿼리의 ‘FROM’ 절에 사용해야 하는 리소스 이름입니다 |
Google 개발자 토큰 |
Google APIs 에 액세스하는 데 필요한 개발자 토큰 |
보고서 특성 |
쉼표로 구분된 보고서 특성 목록 |
보고서 메트릭 |
쉼표로 구분된 보고서 메트릭 목록 |
세그먼트 보고 |
쉼표로 구분된 보고서 세그먼트 목록 |
Report Start Date |
수집이 시작되어야 하는 시작 날짜입니다. |
상태 관리¶
범위 |
설명 |
|---|---|
CLUSTER |
스키마 변경을 감지하기 위해 마지막 보고서 정의에 대한 정보를 해시 형태로 저장합니다. 증분 수집(‘segments.date’ 세그먼트 선택 시)에서는 최근 수집된 날짜를 추적하여 새로운 데이터 청크만 다운로드합니다. 또한 시작 날짜가 저장됩니다. |
관계¶
이름 |
설명 |
|---|---|
실패 |
Google Ads Reporting API 에서 오류 응답을 받거나 응답 처리 중 오류가 발생했을 때 전송되는 오류 FlowFiles 입니다. |
성공 |
Google Ads Reporting API 에서 성공 응답을 받을 때 전송되는 응답 FlowFiles 입니다. |
Writes 특성¶
이름 |
설명 |
|---|---|
google.ads.client.account.id |
특정 보고서를 수집해야 하는 Google Ads 내 계정의 ID |
google.ads.resource.name |
보고서의 출처가 되는 Google Ads 내 리소스 이름 |
google.ads.query |
Google Ads StreamSearch API 에서 데이터를 가져오는 데 사용되는 쿼리 |
google.ads.attributes |
선택한 리소스의 특성 |
google.ads.metrics |
지정된 리소스의 컨텍스트에서 수집된 메트릭 |
google.ads.segments |
메트릭을 그룹화해야 하는 버킷 |
google.ads.ingestion.strategy |
수집에 사용되는 전략입니다. ‘SNAPSHOT’ 또는 ‘INCREMENTAL’ |
google.ads.start.date |
Google Ads에서 데이터를 다운로드한 날짜(해당 날짜 포함) |
google.ads.end.date |
Google Ads에서 데이터를 다운로드한 날짜(해당 날짜 포함) |
google.ads.report.schema.changed |
프로세서 실행 사이에 보고서 스키마가 변경된 경우 플래그 의미 |
google.ads.report.conversion.window |
증분 로딩 중 Google Ads에서 가져온 일수입니다. 변환 윈도우 값 기준 |
fragment.identifier |
각 수집 실행의 고유 ID 입니다. 단일 실행 중에 생성된 모든 플로우 파일을 식별할 수 있습니다. |
fragment.index |
한 번의 수집 실행 중에 생성된 flowfile 배치의 고유 식별자를 나타내는 번호입니다 |
fragment.count |
프로세서 실행 중에 생성된 flowfile의 양 |
avro.schema |
가져온 데이터를 나타내는 Avro 스키마 |
mime.type |
반환된 보고서의 MIME 유형입니다. |