Menginstal library klien

Berikut cara menginstal dan mengonfigurasi library klien atau REST.

Prasyarat

Sebelum menginstal library klien, selesaikan langkah-langkah di Menyiapkan akses API, termasuk mengonfigurasi Kredensial Default Aplikasi (ADC).

Menginstal library

Di komputer lokal Anda, instal library klien pilihan Anda:

REST

Pilih jenis proses penyiapan yang ingin Anda ikuti:

Pengiklan Partner Data

1. Perbarui placeholder dalam contoh berikut, seperti OPERATING_ACCOUNT_PRODUCT, OPERATING_ACCOUNT_ID, dan AUDIENCE_ID, dengan nilai untuk akun dan tujuan Anda.
2. Ganti PROJECT_ID dengan ID Google Cloud Anda.

3. Salin contoh ke command line untuk mengirim permintaan.

   #!/bin/bash
   
   # Uses gcloud to get an access token. If the Application Default
   # Credentials aren't for a service account, the command that specifies
   # --scopes fails. This sample falls back to the command without the
   # --scopes argument.
   DATA_MANAGER_ACCESS_TOKEN="$(gcloud auth application-default print-access-token --scopes=https://www.googleapis.com/auth/datamanager || \
     gcloud auth application-default print-access-token)"
   
   # Fetches and prints the scope information for the access token. If you
   # get scope-related errors when you send the request in the next step,
   # verify that this output includes the Data Manager API scope:
   #   https://www.googleapis.com/auth/datamanager
   curl https://www.googleapis.com/oauth2/v1/tokeninfo?access_token="${DATA_MANAGER_ACCESS_TOKEN}"
   
   # Sends the request.
   curl -X POST "https://datamanager.googleapis.com/v1/audienceMembers:ingest" \
     --header "Authorization: Bearer ${DATA_MANAGER_ACCESS_TOKEN}" \
     --header "x-goog-user-project: PROJECT_ID" \
     --header "Content-Type: application/json" \
     --data @- <<EOF
   
   
       {
     "destinations": [
       {
         "operatingAccount": {
           "accountType": "OPERATING_ACCOUNT_TYPE",
           "accountId": "OPERATING_ACCOUNT_ID"
         },
         "loginAccount": {
           "accountType": "LOGIN_ACCOUNT_TYPE",
           "accountId": "LOGIN_ACCOUNT_ID"
         },
         "productDestinationId": "AUDIENCE_ID"
       }
     ],
     "audienceMembers": [
       {
         "userData": {
           "userIdentifiers": [
             {
               "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
             },
             {
               "emailAddress": "1df6b43bc68dd38eca94e6a65b4f466ae537b796c81a526918b40ac4a7b906c7"
             }
           ]
         }
       },
       {
         "userData": {
           "userIdentifiers": [
             {
               "emailAddress": "2ef46c4214c3fc1b277a2d976d55194e12b899aa50d721f28da858c7689756e3"
             },
             {
               "emailAddress": "54e410b14fa652a4b49b43aff6eaf92ad680d4d1e5e62ed71b86cd3188385a51"
             },
             {
               "emailAddress": "e8bd3f8da6f5af73bec1ab3fbf7beb47482c4766dfdfc94e6bd89e359c139478"
             }
           ]
         }
       },
       {
         "userData": {
           "userIdentifiers": [
             {
               "emailAddress": "05bb62526f091b45d20e243d194766cca8869137421047dc53fa4876d111a6f0"
             },
             {
               "emailAddress": "f1fcde379f31f4d446b76ee8f34860eca2288adc6b6d6c0fdc56d9eee75a2fa5"
             }
           ]
         }
       },
       {
         "userData": {
           "userIdentifiers": [
             {
               "emailAddress": "83a834cc5327bc4dee7c5408988040dc5813c7662611cd93b707aff72bf7d33f"
             },
             {
               "emailAddress": "223ebda6f6889b1494551ba902d9d381daf2f642bae055888e96343d53e9f9c4"
             }
           ]
         }
       }
     ],
     "consent": {
       "adUserData": "CONSENT_GRANTED",
       "adPersonalization": "CONSENT_GRANTED"
     },
     "encoding": "HEX",
     "termsOfService": {
       "customerMatchTermsOfServiceStatus": "ACCEPTED"
     },
     "validateOnly": true
   }
   
     
   
   EOF
   

.NET

Menginstal library klien

Ikuti petunjuk di panduan penginstalan library klien.NET untuk menambahkan dependensi ke library klien dalam project Anda.

Opsional: Dapatkan library utilitas dan contoh kode.

1. Buat clone repositori GitHub.

   git clone https://github.com/googleads/data-manager-dotnet.git
   

2. Dalam project .NET, deklarasikan dependensi ProjectReference pada library utilitas. Ganti PATH_TO_UTILITY_LIBRARY dengan lokasi tempat Anda meng-clone repositori data-manager-dotnet.

   <ProjectReference Include="PATH_TO_UTILITY_LIBRARY\Google.Ads.DataManager.Util\src\Google.Ads.DataManager.Util.csproj" />
   

3. Untuk memformat data, gunakan utilitas Formatter di project .NET Anda.

4. Jelajahi contoh kode di subdirektori samples atau di GitHub.

   Ubah ke direktori samples dan gunakan dotnet run untuk mendapatkan daftar sampel yang tersedia.

   dotnet run
   

   Teruskan argumen --help saat menjalankan contoh untuk mencetak pernyataan penggunaan dengan parameter yang diharapkan.

   dotnet run -- ingest-audience-members --help
   

   Untuk membantu Anda memulai dengan beberapa data sampel, gunakan file di samples/sampledata/audience_members_1.csv.

Java

Menginstal library klien

Ikuti petunjuk dalam panduan penginstalan library klien Java untuk menambahkan dependensi ke library klien dalam project Anda.

Opsional: Dapatkan library utilitas dan contoh kode.

1. Buat clone repositori GitHub.

   git clone https://github.com/googleads/data-manager-java.git
   

2. Arahkan ke direktori data-manager-java.

3. Bangun dan publikasikan library utilitas ke repositori Maven lokal Anda.

   ./gradlew data-manager-util:install
   

4. Dalam project Java Anda, deklarasikan dependensi pada library utilitas.

   Gradle:

   implementation 'com.google.api-ads:data-manager-util:0.2.0'
   

   Maven:

   <dependency>
      <groupId>com.google.api-ads</groupId>
      <artifactId>data-manager-util</artifactId>
      <version>0.2.0</version>
   </dependency>
   

5. Untuk memformat dan mengenkripsi data, gunakan utilitas UserDataFormatter dan Encrypter di project Java Anda.

6. Jelajahi contoh kode di subdirektori data-manager-samples atau di GitHub. Untuk menjalankan sampel dari command line, gunakan tugas Gradle run.

   Misalnya, perintah berikut menjalankan sampel IngestAudienceMembers dan mencetak pernyataan penggunaan:

   ./gradlew data-manager-samples:run \
      --args='IngestAudienceMembers --help'
   

   Untuk membantu Anda memulai dengan beberapa data sampel, gunakan file di data-manager-samples/src/main/resources/sampledata/audience_members_1.csv.

Node.js

Menginstal library klien

Ikuti petunjuk di panduan penginstalan library klien Node.js untuk menambahkan dependensi ke library klien @google-ads/datamanager dalam project Anda.

Opsional: Dapatkan library utilitas dan contoh kode.

1. Buat clone repositori GitHub.

   git clone https://github.com/googleads/data-manager-node.git
   

2. Arahkan ke direktori data-manager-node.

3. Jalankan perintah berikut untuk menginstal dependensi.

   npm install
   

4. Ubah ke direktori util.

   cd util
   

5. Jalankan perintah berikut untuk mengompilasi dan mengemas library utilitas ke dalam file .tgz untuk digunakan dengan npm.

   npm pack
   

   Perintah ini akan membuat arsip bernama google-ads-datamanager-util-0.2.0.tgz. Catat lokasi file agar Anda dapat menggunakannya di langkah berikutnya.

6. Di project Node.js Anda, deklarasikan dependensi pada library utilitas Data Manager API dengan menambahkan entri dependencies untuk jalur lengkap dan nama file google-ads-datamanager-util-0.2.0.tgz.

   {
      "dependencies": {
         ...
         "@google-ads/data-manager-util": "file:PATH_TO_UTILITY_LIBRARY/google-ads-datamanager-util-0.2.0.tgz",
         ...
      }
   }
   

   Untuk memformat data, gunakan utilitas UserDataFormatter di project Node.js Anda.

7. Jelajahi contoh kode di subdirektori samples atau di GitHub. Jalankan contoh menggunakan langkah-langkah berikut:

   1. Arahkan ke direktori data-manager-node.

   2. Jalankan contoh, dengan meneruskan argumen yang diperlukan. Teruskan argumen --help saat menjalankan sampel untuk mencetak pernyataan penggunaan dengan parameter yang diharapkan.

      Misalnya, perintah berikut menjalankan contoh ingest_audience_members dan mencetak pernyataan penggunaan:

      npm run ingest-audience-members -w samples -- --help
      

   Untuk membantu Anda memulai dengan beberapa data sampel, gunakan file di samples/sampledata/audience_members_1.csv.

PHP

Menginstal library klien

Ikuti petunjuk dalam panduan penginstalan library klien PHP untuk menambahkan dependensi ke library klien googleads/data-manager dalam project Anda.

Opsional: Dapatkan library utilitas dan contoh kode.

1. Buat clone repositori GitHub.

   git clone https://github.com/googleads/data-manager-php.git
   

2. Arahkan ke direktori data-manager-php.

3. Jalankan perintah berikut untuk menyelesaikan dependensi library:

   composer update --prefer-dist
   

4. Dalam file composer.json project PHP Anda di host yang sama, deklarasikan dependensi pada library utilitas menggunakan langkah-langkah berikut:

   1. Tambahkan entri di bagian repositories yang mengarah ke lokasi direktori data-manager-php.

      "repositories" : [
         {
            "type" : "path",
            "url" : "PATH_TO_UTILITY_LIBRARY"
         }
      ]
      

   2. Deklarasikan dependensi pada library utilitas.

      "require": {
         "googleads/data-manager-util": "@dev"
      }
      

   Untuk memformat data, gunakan utilitas Formatter di project PHP Anda.

5. Jelajahi contoh kode di subdirektori samples atau di GitHub. Jalankan contoh menggunakan langkah-langkah berikut:

   1. Arahkan ke direktori samples.

   2. Jalankan perintah berikut untuk menyelesaikan dependensi library:

      composer update --prefer-dist
      

   3. Jalankan contoh, dengan meneruskan argumen yang diperlukan. Teruskan argumen --help saat menjalankan sampel untuk mencetak pernyataan penggunaan dengan parameter yang diharapkan.

   Untuk membantu Anda memulai dengan beberapa data sampel, gunakan file di samples/sampledata/audience_members_1.csv.

Python

Menginstal library klien

Ikuti petunjuk di panduan penginstalan library klien Python untuk menambahkan dependensi ke library klien google-ads-datamanager di project Anda.

Opsional: Dapatkan library utilitas dan contoh kode.

1. Buat clone repositori GitHub.

   git clone https://github.com/googleads/data-manager-python.git
   

2. Arahkan ke direktori data-manager-python.

3. Untuk menginstal library utilitas di lingkungan Python, jalankan perintah berikut:

   pip install .
   

4. Di project Python Anda, deklarasikan dependensi pada library utilitas. Misalnya, jika menggunakan file requirements.txt dalam project Anda, tambahkan baris berikut ke file:

   google-ads-data-manager-util=0.2.0
   

5. Untuk memformat dan mengenkripsi data, gunakan utilitas Formatter dan Encrypter di project Python Anda.

6. Jelajahi contoh kode di subdirektori samples atau di GitHub. Untuk menjalankan contoh, instal dependensi yang diperlukan:

   pip install .[samples]
   

   Teruskan argumen --help saat menjalankan contoh untuk mencetak pernyataan penggunaan dengan parameter yang diharapkan.

   Untuk membantu Anda memulai dengan beberapa data sampel, gunakan file di samples/sampledata/audience_members_1.csv.

Ruby

Menginstal library klien

Ikuti petunjuk di panduan penginstalan library klien Ruby untuk menambahkan dependensi ke library klien dalam project Anda.

Langkah berikutnya

• Pelajari lebih lanjut cara mengirim data audiens.
• Pelajari lebih lanjut pengiriman peristiwa.
• Jelajahi dokumentasi referensi REST atau RPC.

Tips: Untuk mencoba metode apa pun, buka referensi REST dan klik tombol API di toolbar pada halaman metode. Baca selengkapnya di Menampilkan APIs Explorer dan menjalankan metode.