Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Membaca dari entitas Google Ads
<a name="googleads-reading-from-entities"></a>

 **Prasyarat** 
+  Objek Google Ads yang ingin Anda baca. Lihat tabel entitas yang didukung di bawah ini untuk memeriksa entitas yang tersedia. 

 **Entitas yang didukung** 


| Entitas | Dapat disaring | Mendukung Batas | Mendukung Order By | Mendukung Pilih\$1 | Mendukung Partisi | 
| --- | --- | --- | --- | --- | --- | 
| Iklan Grup Iklan | Ya | Ya | Ya | Tidak | Ya | 
| Grup Iklan | Ya | Ya | Ya | Tidak | Ya | 
| Anggaran Kampanye | Ya | Ya | Ya | Ya | Ya | 
| Anggaran Akun | Ya | Tidak | Ya | Ya | Tidak | 
| Kampanye | Ya | Ya | Ya | Ya | Ya | 
| Akun | Ya | Tidak | Ya | Tidak | Tidak | 

 **Contoh** 

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

 **Entitas Google Ads dan detail bidang** 


| Entitas | Field | Tipe data | Operator yang Didukung | 
| --- | --- | --- | --- | 
| Akun | ResourceName | String | \$1=, = | 
| Akun | callReportingEnabled | Boolean | \$1=, = | 
| Akun | callConversionReportingDiaktifkan | Boolean | \$1=, = | 
| Akun | callConversionAction | String | \$1=, = | 
| Akun | conversionTrackingId | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Akun | crossAccountConversionTrackingId | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Akun | payPerConversionEligibilityFailureReasons | Daftar |  | 
| Akun | id | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Akun | currencyCode | String | \$1 =, =, SEPERTI | 
| Akun | Zona Waktu | String | \$1 =, =, SEPERTI | 
| Akun | autoTaggingEnabled | Boolean | \$1=, = | 
| Akun | hasPartnersBadge | Boolean | \$1=, = | 
| Akun | manajer | Boolean | \$1=, = | 
| Akun | TestAccount | Boolean | \$1=, = | 
| Akun | date | Date | ANTARA, =, <, >, <=, >= | 
| Akun | CostMicros | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Akun | acceptedCustomerDataKetentuan | Boolean |  | 
| Akun | conversionTrackingStatus | String | \$1 =, =, SEPERTI | 
| Akun | enhancedConversionsForLeadsEnabled | Boolean |  | 
| Akun | googleAdsConversionPelanggan | String |  | 
| Akun | status | String | \$1=, = | 
| Akun | allConversionsByConversionDate | Ganda | \$1=, =, <, > | 
| Akun | allConversionsValueByConversionDate | Ganda | \$1=, =, <, > | 
| Akun | conversionsByConversionTanggal | Ganda | \$1=, =, <, > | 
| Akun | conversionsValueByConversionDate | Ganda | \$1=, =, <, > | 
| Akun | valuePerAllConversionsByConversionDate | Ganda | \$1=, =, <, > | 
| Akun | VideoViews | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Akun | mengeklik | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Akun | InvalidClicks | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Akun | costPerAllKonversi | Ganda | \$1=, =, <, > | 
| Akun | costPerConversion | Ganda | \$1=, =, <, > | 
| Akun | konversi | Ganda | \$1=, =, <, > | 
| Akun | absoluteTopImpressionPersentase | Ganda | \$1=, =, <, > | 
| Akun | kesan | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Akun | topImpressionPercentage | Ganda | \$1=, =, <, > | 
| Akun | Rata-rataECPC | Ganda | \$1=, =, <, > | 
| Akun | activeViewMeasurableCostMicros | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Akun | Rata-RataCost | Ganda | \$1=, =, <, > | 
| Akun | ctr | Ganda | \$1=, =, <, > | 
| Akun | activeViewCtr | Ganda | \$1=, =, <, > | 
| Akun | searchImpressionShare | Ganda | \$1=, =, <, > | 
| Akun | ConversionAction | String | \$1=, = | 
| Akun | conversionActionCategory | String | \$1=, = | 
| Akun | conversionActionName | String | \$1 =, =, SEPERTI | 
| Anggaran Akun | ResourceName | String | \$1=, = | 
| Anggaran Akun | status | String | \$1=, = | 
| Anggaran Akun | proposedEndTimeTipe | String | \$1=, = | 
| Anggaran Akun | approvedEndTimeTipe | String | \$1=, = | 
| Anggaran Akun | id | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Anggaran Akun | Pengaturan Penagihan | String | \$1=, = | 
| Anggaran Akun | name | String | \$1 =, =, SEPERTI | 
| Anggaran Akun | approvedStartDateWaktu |  DateTime | ANTARA, =, <, >, <=, >= | 
| Anggaran Akun | proposedSpendingLimitMikro | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Anggaran Akun | approvedSpendingLimitMikro | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Anggaran Akun | adjustedSpendingLimitMikro | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Anggaran Akun | amountServedMicros | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Grup Iklan | ResourceName | String | \$1 =, =, SEPERTI | 
| Grup Iklan | status | String | \$1 =, =, SEPERTI | 
| Grup Iklan | jenis | String | \$1 =, =, SEPERTI | 
| Grup Iklan | id | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Grup Iklan | name | String | \$1 =, =, SEPERTI | 
| Grup Iklan | kampanye | String | \$1=, = | 
| Grup Iklan | cpcBidMicros | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Grup Iklan | targetCpaMicros | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Grup Iklan | cpmBidMicros | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Grup Iklan | cpvBidMicros | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Grup Iklan | targetCpmMicros | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Grup Iklan | effectiveTargetCpaMikro | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Grup Iklan | date | Date | ANTARA, =, <, >, <=, >= | 
| Grup Iklan | CostMicros | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Grup Iklan | useAudienceGrouped | Boolean | \$1=, = | 
| Grup Iklan | effectiveCpcBidMikro | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Grup Iklan | allConversionsByConversionDate | Ganda | \$1=, =, <, > | 
| Grup Iklan | allConversionsValueByConversionDate | Ganda | \$1=, =, <, > | 
| Grup Iklan | conversionsByConversionTanggal | Ganda | \$1=, =, <, > | 
| Grup Iklan | conversionsValueByConversionDate | Ganda | \$1=, =, <, > | 
| Grup Iklan | valuePerAllConversionsByConversionDate | Ganda | \$1=, =, <, > | 
| Grup Iklan | valuePerConversionsByConversionDate | Ganda | \$1=, =, <, > | 
| Grup Iklan | Rata-RataCost | Ganda | \$1=, =, <, > | 
| Grup Iklan | costPerAllKonversi | Ganda | \$1=, =, <, > | 
| Grup Iklan | costPerConversion | Ganda | \$1=, =, <, > | 
| Grup Iklan | averagePageViews | Ganda | \$1=, =, <, > | 
| Grup Iklan | VideoViews | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Grup Iklan | mengeklik | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Grup Iklan | AllConsions | Ganda | \$1=, =, <, > | 
| Grup Iklan | Rata-rataECPC | Ganda | \$1=, =, <, > | 
| Grup Iklan | absoluteTopImpressionPersentase | Ganda | \$1=, =, <, > | 
| Grup Iklan | kesan | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Grup Iklan | topImpressionPercentage | Ganda | \$1=, =, <, > | 
| Grup Iklan | activeViewCtr | Ganda | \$1=, =, <, > | 
| Grup Iklan | ctr | Ganda | \$1=, =, <, > | 
| Grup Iklan | searchTopImpressionBagikan | Ganda | \$1=, =, <, > | 
| Grup Iklan | searchImpressionShare | Ganda | \$1=, =, <, > | 
| Grup Iklan | searchAbsoluteTopImpressionShare | Ganda | \$1=, =, <, > | 
| Grup Iklan | RelativeCTR | Ganda | \$1=, =, <, > | 
| Grup Iklan | ConversionAction | String | \$1=, = | 
| Grup Iklan | conversionActionCategory | String | \$1=, = | 
| Grup Iklan | conversionActionName | String | \$1 =, =, SEPERTI | 
| Grup Iklan | UpdateMask | String |  | 
| Grup Iklan | buat | Struct |  | 
| Grup Iklan | perbarui | Struct |  | 
| Grup Iklan | PrimaryStatus | String | \$1=, = | 
| Grup Iklan | primaryStatusReasons | Daftar |  | 
| Iklan Grup Iklan | ResourceName | String | \$1=, = | 
| Iklan Grup Iklan | id | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Iklan Grup Iklan | status | String | \$1=, = | 
| Iklan Grup Iklan | label | Daftar |  | 
| Iklan Grup Iklan | AdGroup | String | \$1=, = | 
| Iklan Grup Iklan | CostMicros | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Iklan Grup Iklan | Status Persetujuan | String | \$1=, = | 
| Iklan Grup Iklan | UlasanStatus | String | \$1=, = | 
| Iklan Grup Iklan | AdStrength | String | \$1=, = | 
| Iklan Grup Iklan | jenis | String | \$1=, = | 
| Iklan Grup Iklan | Nama bisnis | String | \$1 =, =, SEPERTI | 
| Iklan Grup Iklan | date | Date | ANTARA, =, <, >, <=, >= | 
| Iklan Grup Iklan | allConversionsByConversionDate | Ganda | \$1=, =, <, > | 
| Iklan Grup Iklan | allConversionsValueByConversionDate | Ganda | \$1=, =, <, > | 
| Iklan Grup Iklan | conversionsByConversionTanggal | Ganda | \$1=, =, <, > | 
| Iklan Grup Iklan | conversionsValueByConversionDate | Ganda | \$1=, =, <, > | 
| Iklan Grup Iklan | valuePerAllConversionsByConversionDate | Ganda | \$1=, =, <, > | 
| Iklan Grup Iklan | valuePerConversionsByConversionDate | Ganda | \$1=, =, <, > | 
| Iklan Grup Iklan | activeViewMeasurableCostMicros | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Iklan Grup Iklan | Rata-RataCost | Ganda | \$1=, =, <, > | 
| Iklan Grup Iklan | costPerAllKonversi | Ganda | \$1=, =, <, > | 
| Iklan Grup Iklan | costPerConversion | Ganda | \$1=, =, <, > | 
| Iklan Grup Iklan | mengeklik | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Iklan Grup Iklan | averagePageViews | Ganda | \$1=, =, <, > | 
| Iklan Grup Iklan | VideoViews | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Iklan Grup Iklan | AllConsions | Ganda | \$1=, =, <, > | 
| Iklan Grup Iklan | Rata-rataECPC | Ganda | \$1=, =, <, > | 
| Iklan Grup Iklan | topImpressionPercentage | Ganda | \$1=, =, <, > | 
| Iklan Grup Iklan | kesan | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Iklan Grup Iklan | absoluteTopImpressionPersentase | Ganda | \$1=, =, <, > | 
| Iklan Grup Iklan | activeViewCtr | Ganda | \$1=, =, <, > | 
| Iklan Grup Iklan | ctr | Ganda | \$1=, =, <, > | 
| Iklan Grup Iklan | ConversionAction | String | \$1=, = | 
| Iklan Grup Iklan | conversionActionCategory | String | \$1=, = | 
| Iklan Grup Iklan | conversionActionName | String | \$1 =, =, SEPERTI | 
| Iklan Grup Iklan | UpdateMask | String |  | 
| Iklan Grup Iklan | buat | Struct |  | 
| Iklan Grup Iklan | perbarui | Struct |  | 
| Iklan Grup Iklan | policyValidationParameter | Struct |  | 
| Iklan Grup Iklan | PrimaryStatus | String | \$1=, = | 
| Iklan Grup Iklan | primaryStatusReasons | Daftar |  | 
| Kampanye | ResourceName | String | \$1=, = | 
| Kampanye | status | String | \$1=, = | 
| Kampanye | BaseCampaign | String | \$1=, = | 
| Kampanye | name | String | \$1 =, =, SEPERTI | 
| Kampanye | id | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Kampanye | Kampanye Anggaran | String | \$1 =, =, SEPERTI | 
| Kampanye | StartDate | Date | ANTARA, =, <, >, <=, >= | 
| Kampanye | EndDate | Date | ANTARA, =, <, >, <=, >= | 
| Kampanye | adServingOptimizationStatus | String | \$1=, = | 
| Kampanye | advertisingChannelType | String | \$1=, = | 
| Kampanye | advertisingChannelSubTipe | String | \$1=, = | 
| Kampanye | ExperimentType | String | \$1=, = | 
| Kampanye | Status Penyajian | String | \$1=, = | 
| Kampanye | biddingStrategyType | String | \$1=, = | 
| Kampanye | domainName | String | \$1 =, =, SEPERTI | 
| Kampanye | languageCode | String | \$1 =, =, SEPERTI | 
| Kampanye | useSuppliedUrlsHanya | Boolean | \$1=, = | 
| Kampanye | positiveGeoTargetTipe | String | \$1=, = | 
| Kampanye | negativeGeoTargetTipe | String | \$1=, = | 
| Kampanye | Mode Pembayaran | String | \$1=, = | 
| Kampanye | optimizationGoalTypes | Daftar |  | 
| Kampanye | date | Date | ANTARA, =, <, >, <=, >= | 
| Kampanye | Rata-RataCost | Ganda |  | 
| Kampanye | mengeklik | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Kampanye | CostMicros | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Kampanye | kesan | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Kampanye | useAudienceGrouped | Boolean | \$1=, = | 
| Kampanye | activeViewMeasurableCostMicros | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Kampanye | costPerAllKonversi | Ganda | \$1=, =, <, > | 
| Kampanye | costPerConversion | Ganda | \$1=, =, <, > | 
| Kampanye | InvalidClicks | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Kampanye | publisherPurchasedClicks | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Kampanye | averagePageViews | Ganda | \$1=, =, <, > | 
| Kampanye | VideoViews | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Kampanye | allConversionsByConversionDate | Ganda | \$1=, =, <, > | 
| Kampanye | allConversionsValueByConversionDate | Ganda | \$1=, =, <, > | 
| Kampanye | conversionsByConversionTanggal | Ganda | \$1=, =, <, > | 
| Kampanye | conversionsValueByConversionDate | Ganda | \$1=, =, <, > | 
| Kampanye | valuePerAllConversionsByConversionDate | Ganda | \$1=, =, <, > | 
| Kampanye | valuePerConversionsByConversionDate | Ganda | \$1=, =, <, > | 
| Kampanye | AllConsions | Ganda | \$1=, =, <, > | 
| Kampanye | absoluteTopImpressionPersentase | Ganda | \$1=, =, <, > | 
| Kampanye | searchAbsoluteTopImpressionShare | Ganda | \$1=, =, <, > | 
| Kampanye | Rata-rataECPC | Ganda | \$1=, =, <, > | 
| Kampanye | searchImpressionShare | Ganda | \$1=, =, <, > | 
| Kampanye | searchTopImpressionBagikan | Ganda | \$1=, =, <, > | 
| Kampanye | activeViewCtr | Ganda | \$1=, =, <, > | 
| Kampanye | ctr | Ganda | \$1=, =, <, > | 
| Kampanye | RelativeCTR | Ganda | \$1=, =, <, > | 
| Kampanye | UpdateMask | String |  | 
| Kampanye | buat | Struct |  | 
| Kampanye | perbarui | Struct |  | 
| Anggaran Kampanye | ResourceName | String | \$1=, = | 
| Anggaran Kampanye | id | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Anggaran Kampanye | status | String | \$1=, = | 
| Anggaran Kampanye | DeliveryMethod | String | \$1=, = | 
| Anggaran Kampanye | periode | String | \$1=, = | 
| Anggaran Kampanye | jenis | String | \$1=, = | 
| Anggaran Kampanye | name | String | \$1 =, =, SEPERTI | 
| Anggaran Kampanye | AmountMicros | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Anggaran Kampanye | Dibagikan secara eksplisit | Boolean | \$1=, = | 
| Anggaran Kampanye | ReferensiCount | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Anggaran Kampanye | hasRecommendedBudget | Boolean | \$1=, = | 
| Anggaran Kampanye | date | Date | ANTARA, =, <, >, <=, >= | 
| Anggaran Kampanye | CostMicros | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Anggaran Kampanye | StartDate | Date | ANTARA, =, <, >, <=, >= | 
| Anggaran Kampanye | EndDate | Date | ANTARA, =, <, >, <=, >= | 
| Anggaran Kampanye | maximizeConversionValueTargetRoas | Ganda | \$1=, =, <, > | 
| Anggaran Kampanye | maximizeConversionsTargetCpaMicros | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Anggaran Kampanye | selectiveOptimizationConversionTindakan | String |  | 
| Anggaran Kampanye | Rata-RataCost | Ganda | \$1=, =, <, > | 
| Anggaran Kampanye | costPerAllKonversi | Ganda | \$1=, =, <, > | 
| Anggaran Kampanye | costPerConversion | Ganda | \$1=, =, <, > | 
| Anggaran Kampanye | VideoViews | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Anggaran Kampanye | mengeklik | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Anggaran Kampanye | AllConsions | Ganda | \$1=, =, <, > | 
| Anggaran Kampanye | valuePerAllKonversi | Ganda | \$1=, =, <, > | 
| Anggaran Kampanye | Rata-rataECPC | Ganda | \$1=, =, <, > | 
| Anggaran Kampanye | kesan | BigInteger | ANTARA, =,\$1 =, <, >, <=, >= | 
| Anggaran Kampanye | ctr | Ganda | \$1=, =, <, > | 
| Anggaran Kampanye | UpdateMask | String |  | 
| Anggaran Kampanye | buat | Struct |  | 
| Anggaran Kampanye | perbarui | Struct |  | 

 **Mempartisi kueri** 

 Opsi percikan tambahan`PARTITION_FIELD`,, `LOWER_BOUND``UPPER_BOUND`, `NUM_PARTITIONS` dapat diberikan jika Anda ingin memanfaatkan konkurensi di Spark. Dengan parameter ini, kueri asli akan dibagi menjadi `NUM_PARTITIONS` sejumlah sub-kueri yang dapat dijalankan oleh tugas percikan secara bersamaan. 
+  `PARTITION_FIELD`: nama bidang yang akan digunakan untuk mempartisi kueri. 
+  `LOWER_BOUND`: nilai batas bawah inklusif dari bidang partisi yang dipilih. 

   Untuk tanggal, kami menerima format tanggal Spark yang digunakan dalam kueri Spark SQL. Contoh nilai yang valid:`"2024-02-06"`. 
+  `UPPER_BOUND`: nilai batas atas eksklusif dari bidang partisi yang dipilih. 
+  `NUM_PARTITIONS`: jumlah partisi. 

 Detail dukungan bidang partisi berdasarkan entitas ditangkap dalam tabel berikut. 


| Nama Entitas | Bidang Partisi | Tipe data | 
| --- | --- | --- | 
| Iklan Grup Iklan | date | Date | 
| Grup Iklan | date | Date | 
| Kampanye | date | Date | 
| Anggaran Kampanye | date | Date | 

 **Contoh** 

```
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"
    }
)
```