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

# Menyambung ke Google Ads
<a name="connecting-to-googleads"></a>

 Google Ads API adalah antarmuka terprogram untuk Google Ads, yang digunakan untuk mengelola akun dan kampanye Google Ads yang besar atau kompleks. Jika Anda pengguna Google Ads, Anda dapat terhubung AWS Glue ke akun Google Ads Anda. Kemudian, Anda dapat menggunakan Google Ads sebagai sumber data di lowongan ETL Anda. Jalankan tugas ini untuk mentransfer data antara Google Ads dan AWS layanan atau aplikasi lain yang didukung. 

**Topics**
+ [AWS Glue dukungan untuk Google Ads](googleads-support.md)
+ [Kebijakan yang berisi operasi API untuk membuat dan menggunakan koneksi](googleads-configuring-iam-permissions.md)
+ [Mengonfigurasi Google Ads](googleads-configuring.md)
+ [Mengonfigurasi koneksi Google Ads](googleads-configuring-connections.md)
+ [Membaca dari entitas Google Ads](googleads-reading-from-entities.md)
+ [Opsi koneksi Google Ads](googleads-connection-options.md)
+ [Membuat akun Google Ads](googleads-create-account.md)
+ [Batasan](googleads-connector-limitations.md)

# AWS Glue dukungan untuk Google Ads
<a name="googleads-support"></a>

AWS Glue mendukung Google Ads sebagai berikut:

**Didukung sebagai sumber?**  
Ya. Anda dapat menggunakan lowongan AWS Glue ETL untuk menanyakan data dari Google Ads.

**Didukung sebagai target?**  
Tidak.

**Versi Google Ads API yang didukung**  
v18

# Kebijakan yang berisi operasi API untuk membuat dan menggunakan koneksi
<a name="googleads-configuring-iam-permissions"></a>

 Kebijakan contoh berikut menjelaskan AWS izin yang diperlukan untuk membuat dan menggunakan koneksi. Jika Anda membuat peran baru, buat kebijakan yang berisi hal-hal berikut: 

------
#### [ JSON ]

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "glue:ListConnectionTypes",
        "glue:DescribeConnectionType",
        "glue:RefreshOAuth2Tokens",
        "glue:ListEntities",
        "glue:DescribeEntity"
      ],
      "Resource": "*"
    }
  ]
}
```

------

Anda juga dapat menggunakan kebijakan IAM terkelola berikut untuk mengizinkan akses:
+  [AWSGlueServiceRole](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/service-role/AWSGlueServiceRole)— Memberikan akses ke sumber daya yang diperlukan berbagai AWS Glue proses untuk dijalankan atas nama Anda. Sumber daya ini termasuk AWS Glue, Amazon S3, IAM, CloudWatch Log, dan Amazon EC2. Jika Anda mengikuti konvensi penamaan untuk sumber daya yang ditentukan dalam kebijakan ini, AWS Glue proses memiliki izin yang diperlukan. Kebijakan ini biasanya dilampirkan pada peran yang ditentukan saat menentukan crawler, tugas, dan titik akhir pengembangan. 
+  [AWSGlueConsoleFullAccess](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/AWSGlueConsoleFullAccess)— Memberikan akses penuh ke AWS Glue sumber daya saat identitas yang dilampirkan kebijakan menggunakan Konsol AWS Manajemen. Jika Anda mengikuti konvensi penamaan untuk sumber daya yang ditentukan dalam kebijakan ini, maka pengguna memiliki kemampuan konsol penuh. Kebijakan ini biasanya dilampirkan ke pengguna AWS Glue konsol. 

# Mengonfigurasi Google Ads
<a name="googleads-configuring"></a>

Sebelum dapat digunakan AWS Glue untuk mentransfer dari Google Ads, Anda harus memenuhi persyaratan berikut:

## Persyaratan minimum
<a name="googleads-configuring-min-requirements"></a>
+  Anda memiliki akun Google Ads dengan Email dan Kata Sandi. Untuk informasi selengkapnya tentang cara membuat akun, lihat [Membuat akun Google Ads](googleads-create-account.md). 
+  Akun Google Ads Anda diaktifkan untuk akses API. Semua penggunaan Google Ads API tersedia tanpa biaya tambahan. 
+  Akun Google Ads memungkinkan Anda menginstal aplikasi yang terhubung. Jika Anda tidak memiliki akses ke fungsi ini, hubungi administrator Google Ads Anda. 

 Jika memenuhi persyaratan ini, Anda siap untuk terhubung AWS Glue ke akun Google Ads Anda. 

# Mengonfigurasi koneksi Google Ads
<a name="googleads-configuring-connections"></a>

 Google Ads mendukung jenis `AUTHORIZATION_CODE` hibah untuk OAuth2. 

 Jenis hibah ini dianggap “berkaki tiga” OAuth karena bergantung pada pengalihan pengguna ke server otorisasi pihak ketiga untuk mengautentikasi pengguna. Ini digunakan saat membuat koneksi melalui AWS Glue Konsol. AWS Glue Konsol akan mengarahkan pengguna ke Google Ads tempat pengguna harus masuk dan mengizinkan izin AWS Glue yang diminta untuk mengakses instance Google Ads mereka. 

 Pengguna dapat memilih untuk membuat aplikasi tersambung mereka sendiri di Google Ads dan memberikan ID klien dan rahasia klien mereka sendiri saat membuat koneksi melalui AWS Glue Konsol. Dalam skenario ini, mereka masih akan diarahkan ke Google Ads untuk masuk dan memberi wewenang AWS Glue untuk mengakses sumber daya mereka. 

 Jenis hibah ini menghasilkan token penyegaran dan token akses. Token akses berumur pendek, dan dapat disegarkan secara otomatis tanpa interaksi pengguna menggunakan token penyegaran. 

 Untuk informasi selengkapnya, lihat [dokumentasi Google Ads publik tentang cara membuat aplikasi yang terhubung untuk OAuth alur Kode Otorisasi](https://developers.google.com/workspace/guides/create-credentials). 

Untuk mengonfigurasi koneksi Google Ads:

1.  Di AWS Secrets Manager, buat rahasia dengan detail berikut. Diperlukan untuk membuat rahasia untuk setiap koneksi di AWS Glue. 

   1.  Untuk jenis AuthorizationCode hibah: 
      +  Untuk aplikasi terhubung yang dikelola pelanggan — Rahasia harus berisi aplikasi yang terhubung Rahasia Konsumen dengan kunci `USER_MANAGED_CLIENT_APPLICATION_CLIENT_SECRET` sebagai. 

1. Di AWS Glue Glue Studio, buat koneksi di bawah **Koneksi Data** dengan mengikuti langkah-langkah di bawah ini: 

   1. Saat memilih **jenis Koneksi**, pilih Google Ads.

   1. Berikan Google `developer token` Ads yang ingin Anda sambungkan.

   1. Berikan Google `MANAGER ID` Ads jika Anda ingin masuk sebagai pengelola.

   1.  Pilih peran IAM yang AWS Glue dapat mengasumsikan dan memiliki izin untuk tindakan berikut: 

------
#### [ JSON ]

****  

      ```
      {
        "Version":"2012-10-17",		 	 	 
        "Statement": [
          {
            "Effect": "Allow",
            "Action": [
              "secretsmanager:DescribeSecret",
              "secretsmanager:GetSecretValue",
              "secretsmanager:PutSecretValue",
              "ec2:CreateNetworkInterface",
              "ec2:DescribeNetworkInterfaces",
              "ec2:DeleteNetworkInterface"
            ],
            "Resource": "*"
          }
        ]
      }
      ```

------

   1.  Pilih `secretName` yang ingin Anda gunakan untuk koneksi ini AWS Glue untuk memasukkan token. 

   1.  Pilih opsi jaringan jika Anda ingin menggunakan jaringan Anda. 

1.  Berikan peran IAM yang terkait dengan izin AWS Glue pekerjaan Anda untuk membaca`secretName`. 

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

# Opsi koneksi Google Ads
<a name="googleads-connection-options"></a>

Berikut ini adalah opsi koneksi untuk Google Ads:
+  `ENTITY_NAME`(String) - (Diperlukan) Digunakan untuk Baca/Tulis. Nama Objek Anda di Google Ads. 
+  `API_VERSION`(String) - (Diperlukan) Digunakan untuk Baca/Tulis. Versi Google Ads Rest API yang ingin Anda gunakan. Contoh: v16. 
+  `DEVELOPER_TOKEN`(String) - (Diperlukan) Digunakan untuk Baca/Tulis. Diperlukan untuk mengautentikasi pengembang atau aplikasi yang membuat permintaan ke API. 
+  `MANAGER_ID`(String) - Digunakan untuk Baca/Tulis. Pengenal unik yang memungkinkan Anda mengelola beberapa akun Google Ads. Ini adalah ID pelanggan dari manajer yang berwenang. Jika akses Anda ke akun pelanggan melalui akun manajer, `MANAGER_ID` diperlukan. Untuk informasi selengkapnya, lihat [login-customer-id](https://developers.google.com/google-ads/api/docs/concepts/call-structure#cid). 
+  `SELECTED_FIELDS`(Daftar<String>) - Default: kosong (SELECT \$1). Digunakan untuk Baca. Kolom yang ingin Anda pilih untuk objek. 
+  `FILTER_PREDICATE`(String) - Default: kosong. Digunakan untuk Baca. Itu harus dalam format Spark SQL. 
+  `QUERY`(String) - Default: kosong. Digunakan untuk Baca. Kueri SQL Spark penuh. 
+  `PARTITION_FIELD`(String) - Digunakan untuk Baca. Bidang yang akan digunakan untuk mempartisi kueri. 
+  `LOWER_BOUND`(String) - Digunakan untuk Baca. Nilai batas bawah inklusif dari bidang partisi yang dipilih. 
+  `UPPER_BOUND`(String) - Digunakan untuk Baca. Nilai batas atas eksklusif dari bidang partisi yang dipilih. 
+  `NUM_PARTITIONS`(Integer) - Default: 1. Digunakan untuk Baca. Jumlah partisi untuk dibaca. 

# Membuat akun Google Ads
<a name="googleads-create-account"></a>

1.  Masuk ke [Akun Pengembang Google Ads](https://console.cloud.google.com) dengan kredensialnya, lalu buka \$1. MyProject   
![\[Tangkapan layar menampilkan layar selamat datang untuk masuk ke Akun Pengembang Google Ads.\]](http://docs.aws.amazon.com/id_id/glue/latest/dg/images/google-ads-log-in-developer-account.png)

1.  Pilih **Proyek Baru** dan berikan informasi yang diperlukan untuk membuat proyek Google jika Anda tidak memiliki aplikasi terdaftar di dalamnya.   
![\[Tangkapan layar menunjukkan halaman pilih proyek. Pilih Proyek Baru di sudut kanan atas.\]](http://docs.aws.amazon.com/id_id/glue/latest/dg/images/google-ads-new-project.png)  
![\[Tangkapan layar menunjukkan jendela Proyek Baru untuk memasukkan nama proyek dan memilih lokasi.\]](http://docs.aws.amazon.com/id_id/glue/latest/dg/images/google-ads-new-project-name-location.png)

1.  Pilih **Tab Navigasi**, lalu **API dan Pengaturan**, dan **Buat Id Klien** dan **ClientSecret**yang akan memerlukan konfigurasi lebih lanjut untuk membuat koneksi antara AWS Glue dan GoogleAds. Untuk informasi selengkapnya, lihat [kredensial API](https://console.cloud.google.com/apis/credentials).   
![\[Tangkapan layar menunjukkan halaman konfigurasi APIs dan layanan.\]](http://docs.aws.amazon.com/id_id/glue/latest/dg/images/google-ads-apis-and-services.png)

1.  Pilih **CREATE CREDENTIALS** dan pilih **OAuth client** ID.   
![\[Tangkapan layar menunjukkan halaman konfigurasi APIs dan layanan dengan drop-down Buat Kredensial dan opsi ID klien Oauth disorot.\]](http://docs.aws.amazon.com/id_id/glue/latest/dg/images/google-ads-create-credentials.png)

1.  Pilih **jenis Aplikasi** sebagai **aplikasi Web**.   
![\[Screenshot menunjukkan halaman Create OAuth client ID dan Application type as Web application.\]](http://docs.aws.amazon.com/id_id/glue/latest/dg/images/google-ads-oauth-client-id-application-type.png)

1.  **Di bawah **Authorized Redirect URIs**, tambahkan OAuth Redirect URIs dan pilih Create.** Anda dapat menambahkan beberapa pengalihan URIs jika diperlukan.   
![\[Tangkapan layar menunjukkan halaman Buat ID OAuth klien dan bagian Pengalihan URIs Resmi. Di sini, tambahkan URIs dan pilih ADD URI jika diperlukan. Setelah selesai, pilih CREATE.\]](http://docs.aws.amazon.com/id_id/glue/latest/dg/images/google-ads-oauth-redirect-uris.png)

1.  **ID Klien** dan **Rahasia Klien** Anda akan dibuat saat membuat koneksi antara AWS Glue dan Google Ads.   
![\[Tangkapan layar menunjukkan halaman Buat ID OAuth klien dan bagian Pengalihan URIs Resmi. Di sini, tambahkan URIs dan pilih ADD URI jika diperlukan. Setelah selesai, pilih CREATE.\]](http://docs.aws.amazon.com/id_id/glue/latest/dg/images/google-ads-oauth-client-created.png)

1.  Tambahkan cakupan sesuai dengan kebutuhan aplikasi Anda berdasarkan, pilih **layar OAuth persetujuan** dan berikan informasi yang diperlukan dan tambahkan cakupan berdasarkan persyaratan.   
![\[Tangkapan layar menunjukkan halaman Perbarui cakupan yang dipilih. Pilih cakupan Anda sesuai kebutuhan.\]](http://docs.aws.amazon.com/id_id/glue/latest/dg/images/google-ads-selected-scopes.png)

# Batasan
<a name="googleads-connector-limitations"></a>

Berikut ini adalah batasan untuk konektor Google Ads:
+ `MANAGER_ID`adalah input opsional saat membuat koneksi. Tetapi ketika Anda ingin mengakses pelanggan yang mendasari manajer tertentu, maka `MANAGER_ID` adalah masukan wajib. Tabel di bawah ini menjelaskan batasan akses berdasarkan `MANAGER_ID` apakah disertakan atau tidak dalam koneksi.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/glue/latest/dg/googleads-connector-limitations.html)
+ Ketika akun manajer dipilih sebagai objek, hanya `Account` akan muncul sebagai sub-objek. Di konektor Google Ads, entitas seperti kampanye, iklan, dll., diambil berdasarkan akun klien individual, bukan akun manajer.
+ Anda tidak dapat mengambil metrik untuk akun manajer. Anda dapat mengambil metrik untuk akun klien individual sebagai gantinya.
+  Setiap akun dapat memiliki hingga 10.000 kampanye, termasuk kampanye aktif dan yang dijeda. Untuk informasi selengkapnya, lihat [Kampanye per akun](https://support.google.com/google-ads/answer/6372658). 
+  Saat membuat laporan, jika Anda memilih metrik tertentu untuk ditampilkan, setiap baris yang metrik yang dipilih semuanya nol tidak akan dikembalikan. Untuk informasi selengkapnya, lihat [Nol Metrik](https://developers.google.com/google-ads/api/docs/reporting/zero-metrics?hl=en#exclude_zero_metrics_by_segmenting). 
+  Dengan bidang berikut, alur Pemetaan Lengkap tidak akan berfungsi untuk entitas Iklan Akun, Grup Iklan, dan Grup Iklan, khususnya untuk ConversionAction,,. conversionActionCategory conversionActionName Untuk informasi selengkapnya, lihat [Segmen dan Metrik](https://developers.google.com/google-ads/api/docs/reporting/segmentation?hl=en#selectability_between_segments_and_metrics). 
+ Filter rentang tanggal wajib dilakukan saat `segments.date` bidang dipilih.