# Google Ads 엔터티에서 읽기
<a name="googleads-reading-from-entities"></a>

 **사전 조건** 
+  읽으려는 Google Ads 객체. 사용 가능한 엔터티를 확인하려면 아래 지원되는 엔터티 테이블을 참조하세요.

 **지원되는 엔터티** 


| 개체 | 필터링 가능 | 제한 지원 | 정렬 기준 지원 | Select \$1 지원 | 분할 지원 | 
| --- | --- | --- | --- | --- | --- | 
| 광고 그룹 광고 | 예 | 예 | 예 | 아니요 | 예 | 
| 광고 그룹 | 예 | 예 | 예 | 아니요 | 예 | 
| 캠페인 예산 | 예 | 예 | 예 | 예 | 예 | 
| 계정 예산 | 예 | 아니요 | 예 | 예 | 아니요 | 
| 캠페인 | 예 | 예 | 예 | 예 | 예 | 
| Account | 예 | 아니요 | 예 | 아니요 | 아니요 | 

 **예제** 

```
googleAds_read = glueContext.create_dynamic_frame.from_options(
    connection_type="googleads",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "campaign-3467***",
        "API_VERSION": "v16"
    }
```

 **Google Ads 엔터티 및 필드 세부 정보** 


| 개체 | 필드 | 데이터 형식 | 지원되는 연산자 | 
| --- | --- | --- | --- | 
| Account | resourceName | String | \$1=, = | 
| Account | callReportingEnabled | 불 | \$1=, = | 
| Account | callConversionReportingEnabled | 불 | \$1=, = | 
| Account | callConversionAction | String | \$1=, = | 
| Account | conversionTrackingId | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Account | crossAccountConversionTrackingId | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Account | payPerConversionEligibilityFailureReasons | 나열 |  | 
| Account | id | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Account | currencyCode | String | \$1=, =, LIKE | 
| Account | timeZone | String | \$1=, =, LIKE | 
| Account | autoTaggingEnabled | 불 | \$1=, = | 
| Account | hasPartnersBadge | 불 | \$1=, = | 
| Account | manager | 불 | \$1=, = | 
| Account | testAccount | 불 | \$1=, = | 
| Account | date | 날짜 | BETWEEN, =, <, >, <=, >= | 
| Account | costMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Account | acceptedCustomerDataTerms | 불 |  | 
| Account | conversionTrackingStatus | String | \$1=, =, LIKE | 
| Account | enhancedConversionsForLeadsEnabled | 불 |  | 
| Account | googleAdsConversionCustomer | String |  | 
| Account | status | String | \$1=, = | 
| Account | allConversionsByConversionDate | 배정밀도 실수 | \$1=, =, <, > | 
| Account | allConversionsValueByConversionDate | 배정밀도 실수 | \$1=, =, <, > | 
| Account | conversionsByConversionDate | 배정밀도 실수 | \$1=, =, <, > | 
| Account | conversionsValueByConversionDate | 배정밀도 실수 | \$1=, =, <, > | 
| Account | valuePerAllConversionsByConversionDate | 배정밀도 실수 | \$1=, =, <, > | 
| Account | videoViews | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Account | clicks | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Account | invalidClicks | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Account | costPerAllConversions | 배정밀도 실수 | \$1=, =, <, > | 
| Account | costPerConversion | 배정밀도 실수 | \$1=, =, <, > | 
| Account | conversions | 배정밀도 실수 | \$1=, =, <, > | 
| Account | absoluteTopImpressionPercentage | 배정밀도 실수 | \$1=, =, <, > | 
| Account | impressions | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Account | topImpressionPercentage | 배정밀도 실수 | \$1=, =, <, > | 
| Account | averageCpc | 배정밀도 실수 | \$1=, =, <, > | 
| Account | activeViewMeasurableCostMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Account | averageCost | 배정밀도 실수 | \$1=, =, <, > | 
| Account | ctr | 배정밀도 실수 | \$1=, =, <, > | 
| Account | activeViewCtr | 배정밀도 실수 | \$1=, =, <, > | 
| Account | searchImpressionShare | 배정밀도 실수 | \$1=, =, <, > | 
| Account | conversionAction | String | \$1=, = | 
| Account | conversionActionCategory | String | \$1=, = | 
| Account | conversionActionName | String | \$1=, =, LIKE | 
| 계정 예산 | resourceName | String | \$1=, = | 
| 계정 예산 | status | String | \$1=, = | 
| 계정 예산 | proposedEndTimeType | String | \$1=, = | 
| 계정 예산 | approvedEndTimeType | String | \$1=, = | 
| 계정 예산 | id | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| 계정 예산 | billingSetup | String | \$1=, = | 
| 계정 예산 | name | String | \$1=, =, LIKE | 
| 계정 예산 | approvedStartDateTime |  DateTime | BETWEEN, =, <, >, <=, >= | 
| 계정 예산 | proposedSpendingLimitMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| 계정 예산 | approvedSpendingLimitMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| 계정 예산 | adjustedSpendingLimitMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| 계정 예산 | amountServedMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| 광고 그룹 | resourceName | String | \$1=, =, LIKE | 
| 광고 그룹 | status | String | \$1=, =, LIKE | 
| 광고 그룹 | type | String | \$1=, =, LIKE | 
| 광고 그룹 | id | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| 광고 그룹 | name | String | \$1=, =, LIKE | 
| 광고 그룹 | campaign | String | \$1=, = | 
| 광고 그룹 | cpcBidMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| 광고 그룹 | targetCpaMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| 광고 그룹 | cpmBidMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| 광고 그룹 | cpvBidMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| 광고 그룹 | targetCpmMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| 광고 그룹 | effectiveTargetCpaMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| 광고 그룹 | date | 날짜 | BETWEEN, =, <, >, <=, >= | 
| 광고 그룹 | costMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| 광고 그룹 | useAudienceGrouped | 불 | \$1=, = | 
| 광고 그룹 | effectiveCpcBidMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| 광고 그룹 | allConversionsByConversionDate | 배정밀도 실수 | \$1=, =, <, > | 
| 광고 그룹 | allConversionsValueByConversionDate | 배정밀도 실수 | \$1=, =, <, > | 
| 광고 그룹 | conversionsByConversionDate | 배정밀도 실수 | \$1=, =, <, > | 
| 광고 그룹 | conversionsValueByConversionDate | 배정밀도 실수 | \$1=, =, <, > | 
| 광고 그룹 | valuePerAllConversionsByConversionDate | 배정밀도 실수 | \$1=, =, <, > | 
| 광고 그룹 | valuePerConversionsByConversionDate | 배정밀도 실수 | \$1=, =, <, > | 
| 광고 그룹 | averageCost | 배정밀도 실수 | \$1=, =, <, > | 
| 광고 그룹 | costPerAllConversions | 배정밀도 실수 | \$1=, =, <, > | 
| 광고 그룹 | costPerConversion | 배정밀도 실수 | \$1=, =, <, > | 
| 광고 그룹 | averagePageViews | 배정밀도 실수 | \$1=, =, <, > | 
| 광고 그룹 | videoViews | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| 광고 그룹 | clicks | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| 광고 그룹 | allConversions | 배정밀도 실수 | \$1=, =, <, > | 
| 광고 그룹 | averageCpc | 배정밀도 실수 | \$1=, =, <, > | 
| 광고 그룹 | absoluteTopImpressionPercentage | 배정밀도 실수 | \$1=, =, <, > | 
| 광고 그룹 | impressions | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| 광고 그룹 | topImpressionPercentage | 배정밀도 실수 | \$1=, =, <, > | 
| 광고 그룹 | activeViewCtr | 배정밀도 실수 | \$1=, =, <, > | 
| 광고 그룹 | ctr | 배정밀도 실수 | \$1=, =, <, > | 
| 광고 그룹 | searchTopImpressionShare | 배정밀도 실수 | \$1=, =, <, > | 
| 광고 그룹 | searchImpressionShare | 배정밀도 실수 | \$1=, =, <, > | 
| 광고 그룹 | searchAbsoluteTopImpressionShare | 배정밀도 실수 | \$1=, =, <, > | 
| 광고 그룹 | relativeCtr | 배정밀도 실수 | \$1=, =, <, > | 
| 광고 그룹 | conversionAction | String | \$1=, = | 
| 광고 그룹 | conversionActionCategory | String | \$1=, = | 
| 광고 그룹 | conversionActionName | String | \$1=, =, LIKE | 
| 광고 그룹 | updateMask | String |  | 
| 광고 그룹 | 생성 | Struct |  | 
| 광고 그룹 | 업데이트 | Struct |  | 
| 광고 그룹 | primaryStatus | String | \$1=, = | 
| 광고 그룹 | primaryStatusReasons | 나열 |  | 
| 광고 그룹 광고 | resourceName | String | \$1=, = | 
| 광고 그룹 광고 | id | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| 광고 그룹 광고 | status | String | \$1=, = | 
| 광고 그룹 광고 | labels | 나열 |  | 
| 광고 그룹 광고 | adGroup | String | \$1=, = | 
| 광고 그룹 광고 | costMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| 광고 그룹 광고 | approvalStatus | String | \$1=, = | 
| 광고 그룹 광고 | reviewStatus | String | \$1=, = | 
| 광고 그룹 광고 | adStrength | String | \$1=, = | 
| 광고 그룹 광고 | type | String | \$1=, = | 
| 광고 그룹 광고 | businessName | String | \$1=, =, LIKE | 
| 광고 그룹 광고 | date | 날짜 | BETWEEN, =, <, >, <=, >= | 
| 광고 그룹 광고 | allConversionsByConversionDate | 배정밀도 실수 | \$1=, =, <, > | 
| 광고 그룹 광고 | allConversionsValueByConversionDate | 배정밀도 실수 | \$1=, =, <, > | 
| 광고 그룹 광고 | conversionsByConversionDate | 배정밀도 실수 | \$1=, =, <, > | 
| 광고 그룹 광고 | conversionsValueByConversionDate | 배정밀도 실수 | \$1=, =, <, > | 
| 광고 그룹 광고 | valuePerAllConversionsByConversionDate | 배정밀도 실수 | \$1=, =, <, > | 
| 광고 그룹 광고 | valuePerConversionsByConversionDate | 배정밀도 실수 | \$1=, =, <, > | 
| 광고 그룹 광고 | activeViewMeasurableCostMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| 광고 그룹 광고 | averageCost | 배정밀도 실수 | \$1=, =, <, > | 
| 광고 그룹 광고 | costPerAllConversions | 배정밀도 실수 | \$1=, =, <, > | 
| 광고 그룹 광고 | costPerConversion | 배정밀도 실수 | \$1=, =, <, > | 
| 광고 그룹 광고 | clicks | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| 광고 그룹 광고 | averagePageViews | 배정밀도 실수 | \$1=, =, <, > | 
| 광고 그룹 광고 | videoViews | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| 광고 그룹 광고 | allConversions | 배정밀도 실수 | \$1=, =, <, > | 
| 광고 그룹 광고 | averageCpc | 배정밀도 실수 | \$1=, =, <, > | 
| 광고 그룹 광고 | topImpressionPercentage | 배정밀도 실수 | \$1=, =, <, > | 
| 광고 그룹 광고 | impressions | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| 광고 그룹 광고 | absoluteTopImpressionPercentage | 배정밀도 실수 | \$1=, =, <, > | 
| 광고 그룹 광고 | activeViewCtr | 배정밀도 실수 | \$1=, =, <, > | 
| 광고 그룹 광고 | ctr | 배정밀도 실수 | \$1=, =, <, > | 
| 광고 그룹 광고 | conversionAction | String | \$1=, = | 
| 광고 그룹 광고 | conversionActionCategory | String | \$1=, = | 
| 광고 그룹 광고 | conversionActionName | String | \$1=, =, LIKE | 
| 광고 그룹 광고 | updateMask | String |  | 
| 광고 그룹 광고 | 생성 | Struct |  | 
| 광고 그룹 광고 | 업데이트 | Struct |  | 
| 광고 그룹 광고 | policyValidationParameter | Struct |  | 
| 광고 그룹 광고 | primaryStatus | String | \$1=, = | 
| 광고 그룹 광고 | primaryStatusReasons | 나열 |  | 
| 캠페인 | resourceName | String | \$1=, = | 
| 캠페인 | status | String | \$1=, = | 
| 캠페인 | baseCampaign | String | \$1=, = | 
| 캠페인 | name | String | \$1=, =, LIKE | 
| 캠페인 | id | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| 캠페인 | campaignBudget | String | \$1=, =, LIKE | 
| 캠페인 | startDate | 날짜 | BETWEEN, =, <, >, <=, >= | 
| 캠페인 | endDate | 날짜 | BETWEEN, =, <, >, <=, >= | 
| 캠페인 | adServingOptimizationStatus | String | \$1=, = | 
| 캠페인 | advertisingChannelType | String | \$1=, = | 
| 캠페인 | advertisingChannelSubType | String | \$1=, = | 
| 캠페인 | experimentType | String | \$1=, = | 
| 캠페인 | servingStatus | String | \$1=, = | 
| 캠페인 | biddingStrategyType | String | \$1=, = | 
| 캠페인 | domainName | String | \$1=, =, LIKE | 
| 캠페인 | languageCode | String | \$1=, =, LIKE | 
| 캠페인 | useSuppliedUrlsOnly | 불 | \$1=, = | 
| 캠페인 | positiveGeoTargetType | String | \$1=, = | 
| 캠페인 | negativeGeoTargetType | String | \$1=, = | 
| 캠페인 | paymentMode | String | \$1=, = | 
| 캠페인 | optimizationGoalTypes | 나열 |  | 
| 캠페인 | date | 날짜 | BETWEEN, =, <, >, <=, >= | 
| 캠페인 | averageCost | 배정밀도 실수 |  | 
| 캠페인 | clicks | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| 캠페인 | costMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| 캠페인 | impressions | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| 캠페인 | useAudienceGrouped | 불 | \$1=, = | 
| 캠페인 | activeViewMeasurableCostMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| 캠페인 | costPerAllConversions | 배정밀도 실수 | \$1=, =, <, > | 
| 캠페인 | costPerConversion | 배정밀도 실수 | \$1=, =, <, > | 
| 캠페인 | invalidClicks | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| 캠페인 | publisherPurchasedClicks | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| 캠페인 | averagePageViews | 배정밀도 실수 | \$1=, =, <, > | 
| 캠페인 | videoViews | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| 캠페인 | allConversionsByConversionDate | 배정밀도 실수 | \$1=, =, <, > | 
| 캠페인 | allConversionsValueByConversionDate | 배정밀도 실수 | \$1=, =, <, > | 
| 캠페인 | conversionsByConversionDate | 배정밀도 실수 | \$1=, =, <, > | 
| 캠페인 | conversionsValueByConversionDate | 배정밀도 실수 | \$1=, =, <, > | 
| 캠페인 | valuePerAllConversionsByConversionDate | 배정밀도 실수 | \$1=, =, <, > | 
| 캠페인 | valuePerConversionsByConversionDate | 배정밀도 실수 | \$1=, =, <, > | 
| 캠페인 | allConversions | 배정밀도 실수 | \$1=, =, <, > | 
| 캠페인 | absoluteTopImpressionPercentage | 배정밀도 실수 | \$1=, =, <, > | 
| 캠페인 | searchAbsoluteTopImpressionShare | 배정밀도 실수 | \$1=, =, <, > | 
| 캠페인 | averageCpc | 배정밀도 실수 | \$1=, =, <, > | 
| 캠페인 | searchImpressionShare | 배정밀도 실수 | \$1=, =, <, > | 
| 캠페인 | searchTopImpressionShare | 배정밀도 실수 | \$1=, =, <, > | 
| 캠페인 | activeViewCtr | 배정밀도 실수 | \$1=, =, <, > | 
| 캠페인 | ctr | 배정밀도 실수 | \$1=, =, <, > | 
| 캠페인 | relativeCtr | 배정밀도 실수 | \$1=, =, <, > | 
| 캠페인 | updateMask | String |  | 
| 캠페인 | 생성 | Struct |  | 
| 캠페인 | 업데이트 | Struct |  | 
| 캠페인 예산 | resourceName | String | \$1=, = | 
| 캠페인 예산 | id | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| 캠페인 예산 | status | String | \$1=, = | 
| 캠페인 예산 | deliveryMethod | String | \$1=, = | 
| 캠페인 예산 | 기간 | String | \$1=, = | 
| 캠페인 예산 | type | String | \$1=, = | 
| 캠페인 예산 | name | String | \$1=, =, LIKE | 
| 캠페인 예산 | amountMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| 캠페인 예산 | explicitlyShared | 불 | \$1=, = | 
| 캠페인 예산 | referenceCount | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| 캠페인 예산 | hasRecommendedBudget | 불 | \$1=, = | 
| 캠페인 예산 | date | 날짜 | BETWEEN, =, <, >, <=, >= | 
| 캠페인 예산 | costMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| 캠페인 예산 | startDate | 날짜 | BETWEEN, =, <, >, <=, >= | 
| 캠페인 예산 | endDate | 날짜 | BETWEEN, =, <, >, <=, >= | 
| 캠페인 예산 | maximizeConversionValueTargetRoas | 배정밀도 실수 | \$1=, =, <, > | 
| 캠페인 예산 | maximizeConversionsTargetCpaMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| 캠페인 예산 | selectiveOptimizationConversionActions | String |  | 
| 캠페인 예산 | averageCost | 배정밀도 실수 | \$1=, =, <, > | 
| 캠페인 예산 | costPerAllConversions | 배정밀도 실수 | \$1=, =, <, > | 
| 캠페인 예산 | costPerConversion | 배정밀도 실수 | \$1=, =, <, > | 
| 캠페인 예산 | videoViews | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| 캠페인 예산 | clicks | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| 캠페인 예산 | allConversions | 배정밀도 실수 | \$1=, =, <, > | 
| 캠페인 예산 | valuePerAllConversions | 배정밀도 실수 | \$1=, =, <, > | 
| 캠페인 예산 | averageCpc | 배정밀도 실수 | \$1=, =, <, > | 
| 캠페인 예산 | impressions | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| 캠페인 예산 | ctr | 배정밀도 실수 | \$1=, =, <, > | 
| 캠페인 예산 | updateMask | String |  | 
| 캠페인 예산 | 생성 | Struct |  | 
| 캠페인 예산 | 업데이트 | Struct |  | 

 **분할 쿼리** 

 Spark에서 동시성을 활용하려는 경우 추가 Spark 옵션(`PARTITION_FIELD`, `LOWER_BOUND`, `UPPER_BOUND`, `NUM_PARTITIONS`)을 제공할 수 있습니다. 이러한 파라미터를 사용하면 Spark 태스크에서 동시에 실행할 수 있는 `NUM_PARTITIONS`개의 하위 쿼리로 원본 쿼리가 분할됩니다.
+  `PARTITION_FIELD`: 쿼리 분할에 사용할 필드의 이름입니다.
+  `LOWER_BOUND`: 선택한 파티션 필드의 하한 값(경계 포함).

   날짜의 경우 Spark SQL 쿼리에 사용된 Spark 날짜 형식을 허용합니다. 유효한 값의 예제: `"2024-02-06"`.
+  `UPPER_BOUND`: 선택한 파티션 필드의 상한 값(경계 제외).
+  `NUM_PARTITIONS`: 파티션 수.

 엔터티 수준의 분할 필드 지원 세부 정보는 다음 표에 캡처되어 있습니다.


| Entity Name | 분할 필드 | 데이터 형식 | 
| --- | --- | --- | 
| 광고 그룹 광고 | date | 날짜 | 
| 광고 그룹 | date | 날짜 | 
| 캠페인 | date | 날짜 | 
| 캠페인 예산 | date | 날짜 | 

 **예제** 

```
googleads_read = glueContext.create_dynamic_frame.from_options(
    connection_type="googleads",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "campaign-3467***",
        "API_VERSION": "v16",
        "PARTITION_FIELD": "date"
        "LOWER_BOUND": "2024-01-01"
        "UPPER_BOUND": "2024-06-05"
        "NUM_PARTITIONS": "10"
    }
)
```