GetGoogleAdsReport 프로세서
GetGoogleAdsReport 프로세서
Openflow의 GetGoogleAdsReport 프로세서는 Google Ads Reporting API와 상호작용해 보고서를 가져오는 프로세서예요. 기본적으로 하루에 한 번 데이터를 가져와요.
출처: Snowflake 문서
본문
번들 (Bundle)
com.snowflake.openflow.runtime | runtime-google-ads-nar
설명 (Description)
Google Ads Reporting API와 상호작용할 수 있는 프로세서예요. 기본적으로 하루에 한 번 데이터를 가져와요.
태그 (Tags)
Google, Google Ads, report
입력 요구 사항 (Input Requirement)
금지 (FORBIDDEN)
민감 동적 속성 지원 (Supports Sensitive Dynamic Properties)
아니요 (false)
속성 (Properties)
| 속성 | 설명 |
|---|---|
| Client Account ID | 보고서를 가져올 Google Ads 계정의 ID예요. |
| GCP Credentials Service | Google Cloud Platform 자격 증명을 얻는 데 사용하는 컨트롤러 서비스예요. |
| Google Ads Resource Name | 쿼리의 'FROM' 절에 사용해야 할 리소스의 이름이에요. |
| Google Developer Token | Google API에 접근하는 데 필요한 개발자 토큰이에요. |
| Report Attributes | 쉼표로 구분된 보고서 속성 목록이에요. |
| Report Metrics | 쉼표로 구분된 보고서 메트릭 목록이에요. |
| Report Segments | 쉼표로 구분된 보고서 세그먼트 목록이에요. |
| Report Start Date | 수집이 시작되어야 하는 시작 날짜예요. |
상태 관리 (State management)
| 범위 | 설명 |
|---|---|
| CLUSTER | 스키마 변경을 감지하기 위해 마지막 보고서 정의에 대한 정보를 해시 형태로 저장해요. 증분 수집('segments.date' 세그먼트 선택 시)에서는 최신 수집 날짜를 추적해 새 데이터 덩어리만 내려받아요. 또한 시작 날짜를 저장해요. |
관계 (Relationships)
| 이름 | 설명 |
|---|---|
| failure | Google Ads Reporting API에서 오류 응답을 받거나 응답 처리 중 오류가 발생했을 때 전달되는 오류 FlowFile이에요. |
| success | Google Ads Reporting API에서 성공 응답을 받았을 때 전달되는 응답 FlowFile이에요. |
쓰기 속성 (Writes attributes)
| 이름 | 설명 |
|---|---|
| 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에서 가져오는 일수예요. Conversion Window 값을 기준으로 해요. |
| fragment.identifier | 각 수집 실행의 고유 ID예요. 단일 실행 중 생성된 모든 flow file을 식별할 수 있게 해줘요. |
| fragment.index | 한 번의 수집 실행 중 생성된 flowfile 배치에서 고유 식별자를 나타내는 번호예요. |
| fragment.count | 프로세서 실행 중 생성된 flowfile 수예요. |
| avro.schema | 가져온 데이터를 나타내는 Avro 스키마예요. |
| mime.type | 반환된 보고서의 MIME 타입이에요. |