# Google 広告エンティティからの読み取り
<a name="googleads-reading-from-entities"></a>

 **前提条件** 
+  読み取り元の Google 広告オブジェクト。使用可能なエンティティを確認するには、以下のサポートされているエンティティの表を参照してください。

 **サポートされているエンティティ** 


| エンティティ | フィルタリング可能 | 制限をサポートする | Order By をサポートする | Select \$1 をサポートする | パーティション分割をサポートする | 
| --- | --- | --- | --- | --- | --- | 
| Ad Group Ad | はい | あり | あり | なし | あり | 
| Ad Group | はい | あり | あり | なし | あり | 
| Campaign Budget | はい | あり | あり | あり | あり | 
| Account Budget | あり | なし | あり | あり | なし | 
| キャンペーン | はい | あり | あり | あり | あり | 
| アカウント | あり | なし | あり | なし | なし | 

 **例** 

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

 **Google 広告エンティティとフィールドの詳細** 


| エンティティ | フィールド | データタイプ | サポートされている演算子 | 
| --- | --- | --- | --- | 
| アカウント | resourceName | 文字列 | \$1=, = | 
| アカウント | callReportingEnabled | ブール値 | \$1=, = | 
| アカウント | callConversionReportingEnabled | ブール値 | \$1=, = | 
| アカウント | callConversionAction | 文字列 | \$1=, = | 
| アカウント | conversionTrackingId | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| アカウント | crossAccountConversionTrackingId | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| アカウント | payPerConversionEligibilityFailureReasons | リスト |  | 
| アカウント | id | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| アカウント | currencyCode | 文字列 | \$1=, =, LIKE | 
| アカウント | timeZone | 文字列 | \$1=, =, LIKE | 
| アカウント | autoTaggingEnabled | ブール値 | \$1=, = | 
| アカウント | hasPartnersBadge | ブール値 | \$1=, = | 
| アカウント | manager | ブール値 | \$1=, = | 
| アカウント | testAccount | ブール値 | \$1=, = | 
| アカウント | date | 日付 | BETWEEN, =, <, >, <=, >= | 
| アカウント | costMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| アカウント | acceptedCustomerDataTerms | ブール値 |  | 
| アカウント | conversionTrackingStatus | 文字列 | \$1=, =, LIKE | 
| アカウント | enhancedConversionsForLeadsEnabled | ブール値 |  | 
| アカウント | googleAdsConversionCustomer | 文字列 |  | 
| アカウント | ステータス | 文字列 | \$1=, = | 
| アカウント | allConversionsByConversionDate | 倍精度 | \$1=, =, <, > | 
| アカウント | allConversionsValueByConversionDate | 倍精度 | \$1=, =, <, > | 
| アカウント | conversionsByConversionDate | 倍精度 | \$1=, =, <, > | 
| アカウント | conversionsValueByConversionDate | 倍精度 | \$1=, =, <, > | 
| アカウント | valuePerAllConversionsByConversionDate | 倍精度 | \$1=, =, <, > | 
| アカウント | videoViews | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| アカウント | clicks | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| アカウント | invalidClicks | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| アカウント | costPerAllConversions | 倍精度 | \$1=, =, <, > | 
| アカウント | costPerConversion | 倍精度 | \$1=, =, <, > | 
| アカウント | conversions | 倍精度 | \$1=, =, <, > | 
| アカウント | absoluteTopImpressionPercentage | 倍精度 | \$1=, =, <, > | 
| アカウント | IMPRESSION | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| アカウント | topImpressionPercentage | 倍精度 | \$1=, =, <, > | 
| アカウント | averageCpc | 倍精度 | \$1=, =, <, > | 
| アカウント | activeViewMeasurableCostMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| アカウント | averageCost | 倍精度 | \$1=, =, <, > | 
| アカウント | ctr | 倍精度 | \$1=, =, <, > | 
| アカウント | activeViewCtr | 倍精度 | \$1=, =, <, > | 
| アカウント | searchImpressionShare | 倍精度 | \$1=, =, <, > | 
| アカウント | conversionAction | 文字列 | \$1=, = | 
| アカウント | conversionActionCategory | 文字列 | \$1=, = | 
| アカウント | conversionActionName | 文字列 | \$1=, =, LIKE | 
| Account Budget | resourceName | 文字列 | \$1=, = | 
| Account Budget | ステータス | 文字列 | \$1=, = | 
| Account Budget | proposedEndTimeType | 文字列 | \$1=, = | 
| Account Budget | approvedEndTimeType | 文字列 | \$1=, = | 
| Account Budget | id | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Account Budget | billingSetup | 文字列 | \$1=, = | 
| Account Budget | 名前 | 文字列 | \$1=, =, LIKE | 
| Account Budget | approvedStartDateTime |  DateTime | BETWEEN, =, <, >, <=, >= | 
| Account Budget | proposedSpendingLimitMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Account Budget | approvedSpendingLimitMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Account Budget | adjustedSpendingLimitMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Account Budget | amountServedMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Ad Group | resourceName | 文字列 | \$1=, =, LIKE | 
| Ad Group | ステータス | 文字列 | \$1=, =, LIKE | 
| Ad Group | type | 文字列 | \$1=, =, LIKE | 
| Ad Group | id | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Ad Group | 名前 | 文字列 | \$1=, =, LIKE | 
| Ad Group | キャンペーン | 文字列 | \$1=, = | 
| Ad Group | cpcBidMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Ad Group | targetCpaMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Ad Group | cpmBidMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Ad Group | cpvBidMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Ad Group | targetCpmMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Ad Group | effectiveTargetCpaMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Ad Group | date | 日付 | BETWEEN, =, <, >, <=, >= | 
| Ad Group | costMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Ad Group | useAudienceGrouped | ブール値 | \$1=, = | 
| Ad Group | effectiveCpcBidMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Ad Group | allConversionsByConversionDate | 倍精度 | \$1=, =, <, > | 
| Ad Group | allConversionsValueByConversionDate | 倍精度 | \$1=, =, <, > | 
| Ad Group | conversionsByConversionDate | 倍精度 | \$1=, =, <, > | 
| Ad Group | conversionsValueByConversionDate | 倍精度 | \$1=, =, <, > | 
| Ad Group | valuePerAllConversionsByConversionDate | 倍精度 | \$1=, =, <, > | 
| Ad Group | valuePerConversionsByConversionDate | 倍精度 | \$1=, =, <, > | 
| Ad Group | averageCost | 倍精度 | \$1=, =, <, > | 
| Ad Group | costPerAllConversions | 倍精度 | \$1=, =, <, > | 
| Ad Group | costPerConversion | 倍精度 | \$1=, =, <, > | 
| Ad Group | averagePageViews | 倍精度 | \$1=, =, <, > | 
| Ad Group | videoViews | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Ad Group | clicks | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Ad Group | allConversions | 倍精度 | \$1=, =, <, > | 
| Ad Group | averageCpc | 倍精度 | \$1=, =, <, > | 
| Ad Group | absoluteTopImpressionPercentage | 倍精度 | \$1=, =, <, > | 
| Ad Group | IMPRESSION | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Ad Group | topImpressionPercentage | 倍精度 | \$1=, =, <, > | 
| Ad Group | activeViewCtr | 倍精度 | \$1=, =, <, > | 
| Ad Group | ctr | 倍精度 | \$1=, =, <, > | 
| Ad Group | searchTopImpressionShare | 倍精度 | \$1=, =, <, > | 
| Ad Group | searchImpressionShare | 倍精度 | \$1=, =, <, > | 
| Ad Group | searchAbsoluteTopImpressionShare | 倍精度 | \$1=, =, <, > | 
| Ad Group | relativeCtr | 倍精度 | \$1=, =, <, > | 
| Ad Group | conversionAction | 文字列 | \$1=, = | 
| Ad Group | conversionActionCategory | 文字列 | \$1=, = | 
| Ad Group | conversionActionName | 文字列 | \$1=, =, LIKE | 
| Ad Group | updateMask | 文字列 |  | 
| Ad Group | 作成 | Struct |  | 
| Ad Group | 更新 | Struct |  | 
| Ad Group | primaryStatus | 文字列 | \$1=, = | 
| Ad Group | primaryStatusReasons | リスト |  | 
| Ad Group Ad | resourceName | 文字列 | \$1=, = | 
| Ad Group Ad | id | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Ad Group Ad | ステータス | 文字列 | \$1=, = | 
| Ad Group Ad | ラベル | リスト |  | 
| Ad Group Ad | adGroup | 文字列 | \$1=, = | 
| Ad Group Ad | costMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Ad Group Ad | approvalStatus | 文字列 | \$1=, = | 
| Ad Group Ad | reviewStatus | 文字列 | \$1=, = | 
| Ad Group Ad | adStrength | 文字列 | \$1=, = | 
| Ad Group Ad | type | 文字列 | \$1=, = | 
| Ad Group Ad | businessName | 文字列 | \$1=, =, LIKE | 
| Ad Group Ad | date | 日付 | BETWEEN, =, <, >, <=, >= | 
| Ad Group Ad | allConversionsByConversionDate | 倍精度 | \$1=, =, <, > | 
| Ad Group Ad | allConversionsValueByConversionDate | 倍精度 | \$1=, =, <, > | 
| Ad Group Ad | conversionsByConversionDate | 倍精度 | \$1=, =, <, > | 
| Ad Group Ad | conversionsValueByConversionDate | 倍精度 | \$1=, =, <, > | 
| Ad Group Ad | valuePerAllConversionsByConversionDate | 倍精度 | \$1=, =, <, > | 
| Ad Group Ad | valuePerConversionsByConversionDate | 倍精度 | \$1=, =, <, > | 
| Ad Group Ad | activeViewMeasurableCostMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Ad Group Ad | averageCost | 倍精度 | \$1=, =, <, > | 
| Ad Group Ad | costPerAllConversions | 倍精度 | \$1=, =, <, > | 
| Ad Group Ad | costPerConversion | 倍精度 | \$1=, =, <, > | 
| Ad Group Ad | clicks | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Ad Group Ad | averagePageViews | 倍精度 | \$1=, =, <, > | 
| Ad Group Ad | videoViews | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Ad Group Ad | allConversions | 倍精度 | \$1=, =, <, > | 
| Ad Group Ad | averageCpc | 倍精度 | \$1=, =, <, > | 
| Ad Group Ad | topImpressionPercentage | 倍精度 | \$1=, =, <, > | 
| Ad Group Ad | IMPRESSION | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Ad Group Ad | absoluteTopImpressionPercentage | 倍精度 | \$1=, =, <, > | 
| Ad Group Ad | activeViewCtr | 倍精度 | \$1=, =, <, > | 
| Ad Group Ad | ctr | 倍精度 | \$1=, =, <, > | 
| Ad Group Ad | conversionAction | 文字列 | \$1=, = | 
| Ad Group Ad | conversionActionCategory | 文字列 | \$1=, = | 
| Ad Group Ad | conversionActionName | 文字列 | \$1=, =, LIKE | 
| Ad Group Ad | updateMask | 文字列 |  | 
| Ad Group Ad | 作成 | Struct |  | 
| Ad Group Ad | 更新 | Struct |  | 
| Ad Group Ad | policyValidationParameter | Struct |  | 
| Ad Group Ad | primaryStatus | 文字列 | \$1=, = | 
| Ad Group Ad | primaryStatusReasons | リスト |  | 
| キャンペーン | resourceName | 文字列 | \$1=, = | 
| キャンペーン | ステータス | 文字列 | \$1=, = | 
| キャンペーン | baseCampaign | 文字列 | \$1=, = | 
| キャンペーン | 名前 | 文字列 | \$1=, =, LIKE | 
| キャンペーン | id | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| キャンペーン | campaignBudget | 文字列 | \$1=, =, LIKE | 
| キャンペーン | startDate | 日付 | BETWEEN, =, <, >, <=, >= | 
| キャンペーン | endDate | 日付 | BETWEEN, =, <, >, <=, >= | 
| キャンペーン | adServingOptimizationStatus | 文字列 | \$1=, = | 
| キャンペーン | advertisingChannelType | 文字列 | \$1=, = | 
| キャンペーン | advertisingChannelSubType | 文字列 | \$1=, = | 
| キャンペーン | experimentType | 文字列 | \$1=, = | 
| キャンペーン | servingStatus | 文字列 | \$1=, = | 
| キャンペーン | biddingStrategyType | 文字列 | \$1=, = | 
| キャンペーン | domainName | 文字列 | \$1=, =, LIKE | 
| キャンペーン | languageCode | 文字列 | \$1=, =, LIKE | 
| キャンペーン | useSuppliedUrlsOnly | ブール値 | \$1=, = | 
| キャンペーン | positiveGeoTargetType | 文字列 | \$1=, = | 
| キャンペーン | negativeGeoTargetType | 文字列 | \$1=, = | 
| キャンペーン | paymentMode | 文字列 | \$1=, = | 
| キャンペーン | optimizationGoalTypes | リスト |  | 
| キャンペーン | date | 日付 | BETWEEN, =, <, >, <=, >= | 
| キャンペーン | averageCost | 倍精度 |  | 
| キャンペーン | clicks | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| キャンペーン | costMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| キャンペーン | IMPRESSION | 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 | 文字列 |  | 
| キャンペーン | 作成 | Struct |  | 
| キャンペーン | 更新 | Struct |  | 
| Campaign Budget | resourceName | 文字列 | \$1=, = | 
| Campaign Budget | id | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Campaign Budget | ステータス | 文字列 | \$1=, = | 
| Campaign Budget | deliveryMethod | 文字列 | \$1=, = | 
| Campaign Budget | 期間 | 文字列 | \$1=, = | 
| Campaign Budget | type | 文字列 | \$1=, = | 
| Campaign Budget | 名前 | 文字列 | \$1=, =, LIKE | 
| Campaign Budget | amountMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Campaign Budget | explicitlyShared | ブール値 | \$1=, = | 
| Campaign Budget | referenceCount | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Campaign Budget | hasRecommendedBudget | ブール値 | \$1=, = | 
| Campaign Budget | date | 日付 | BETWEEN, =, <, >, <=, >= | 
| Campaign Budget | costMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Campaign Budget | startDate | 日付 | BETWEEN, =, <, >, <=, >= | 
| Campaign Budget | endDate | 日付 | BETWEEN, =, <, >, <=, >= | 
| Campaign Budget | maximizeConversionValueTargetRoas | 倍精度 | \$1=, =, <, > | 
| Campaign Budget | maximizeConversionsTargetCpaMicros | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Campaign Budget | selectiveOptimizationConversionActions | 文字列 |  | 
| Campaign Budget | averageCost | 倍精度 | \$1=, =, <, > | 
| Campaign Budget | costPerAllConversions | 倍精度 | \$1=, =, <, > | 
| Campaign Budget | costPerConversion | 倍精度 | \$1=, =, <, > | 
| Campaign Budget | videoViews | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Campaign Budget | clicks | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Campaign Budget | allConversions | 倍精度 | \$1=, =, <, > | 
| Campaign Budget | valuePerAllConversions | 倍精度 | \$1=, =, <, > | 
| Campaign Budget | averageCpc | 倍精度 | \$1=, =, <, > | 
| Campaign Budget | IMPRESSION | BigInteger | BETWEEN, =, \$1=, <, >, <=, >= | 
| Campaign Budget | ctr | 倍精度 | \$1=, =, <, > | 
| Campaign Budget | updateMask | 文字列 |  | 
| Campaign Budget | 作成 | Struct |  | 
| Campaign Budget | 更新 | 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`: パーティション数。

 エンティティごとのパーティション分割フィールドのサポートの詳細は、次の表にまとめられています。


| エンティティ名 | Partitioning Field | データタイプ | 
| --- | --- | --- | 
| Ad Group Ad | date | 日付 | 
| Ad Group | date | 日付 | 
| キャンペーン | date | 日付 | 
| Campaign Budget | 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"
    }
)
```