Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

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).

Langkah-langkah penginstalan

Di komputer lokal, instal library klien pilihan Anda:

REST

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

Salin contoh ke command line untuk mengirim permintaan. Hanya gunakan contoh Partner data jika Anda mengakses akun operasi melalui link partner. Jika tidak, gunakan contoh Pengiklan.

Pengiklan

#!/bin/bash

# Uses gcloud to get an access token. If the Application Default
# Credentials aren't for a service account then the command that
# specifies --scopes fails, so 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": [
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
            },
            {
              "emailAddress": "1df6b43bc68dd38eca94e6a65b4f466ae537b796c81a526918b40ac4a7b906c7"
            }
          ]
        }
      }
    },
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "2ef46c4214c3fc1b277a2d976d55194e12b899aa50d721f28da858c7689756e3"
            },
            {
              "emailAddress": "54e410b14fa652a4b49b43aff6eaf92ad680d4d1e5e62ed71b86cd3188385a51"
            },
            {
              "emailAddress": "e8bd3f8da6f5af73bec1ab3fbf7beb47482c4766dfdfc94e6bd89e359c139478"
            }
          ]
        }
      }
    },
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "05bb62526f091b45d20e243d194766cca8869137421047dc53fa4876d111a6f0"
            },
            {
              "emailAddress": "f1fcde379f31f4d446b76ee8f34860eca2288adc6b6d6c0fdc56d9eee75a2fa5"
            }
          ]
        }
      }
    },
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "83a834cc5327bc4dee7c5408988040dc5813c7662611cd93b707aff72bf7d33f"
            },
            {
              "emailAddress": "223ebda6f6889b1494551ba902d9d381daf2f642bae055888e96343d53e9f9c4"
            }
          ]
        }
      }
    }
  ],
  "consent": {
    "adUserData": "CONSENT_GRANTED",
    "adPersonalization": "CONSENT_GRANTED"
  },
  "encoding": "HEX",
  "termsOfService": {
    "customerMatchTermsOfServiceStatus": "ACCEPTED"
  },
  "validateOnly": true
}
EOF

Partner data

#!/bin/bash

# Uses gcloud to get an access token. If the Application Default
# Credentials aren't for a service account then the command that
# specifies --scopes fails, so 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"
      },
      "linkedAccount": {
        "accountType": "LINKED_ACCOUNT_TYPE",
        "accountId": "LINKED_ACCOUNT_ID"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ],
  "audienceMembers": [
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
            },
            {
              "emailAddress": "1df6b43bc68dd38eca94e6a65b4f466ae537b796c81a526918b40ac4a7b906c7"
            }
          ]
        }
      }
    },
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "2ef46c4214c3fc1b277a2d976d55194e12b899aa50d721f28da858c7689756e3"
            },
            {
              "emailAddress": "54e410b14fa652a4b49b43aff6eaf92ad680d4d1e5e62ed71b86cd3188385a51"
            },
            {
              "emailAddress": "e8bd3f8da6f5af73bec1ab3fbf7beb47482c4766dfdfc94e6bd89e359c139478"
            }
          ]
        }
      }
    },
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "05bb62526f091b45d20e243d194766cca8869137421047dc53fa4876d111a6f0"
            },
            {
              "emailAddress": "f1fcde379f31f4d446b76ee8f34860eca2288adc6b6d6c0fdc56d9eee75a2fa5"
            }
          ]
        }
      }
    },
    {
      "compositeData": {
        "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 dalam panduan penginstalan library klien.NET untuk menambahkan dependensi ke library klien dalam project Anda.

Opsional: Menginstal library utilitas

Selain library klien, Anda dapat menginstal library utilitas untuk membantu tugas umum seperti memformat data untuk penyerapan.

Dalam project .NET, deklarasikan dependensi pada library utilitas Google.Ads.DataManager.Util.
```
dotnet add package Google.Ads.DataManager.Util --version 0.4.0
```
Untuk memformat data, gunakan utilitas UserDataFormatter di project .NET Anda.

Mempelajari contoh kode

Jelajahi contoh kode di subdirektori samples atau di GitHub.

Untuk menjalankan contoh:

Clone repositori GitHub di tag v0.4.0:

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

Arahkan ke direktori data-manager-dotnet.
Ubah ke direktori samples dan gunakan dotnet run untuk mendapatkan daftar contoh 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.

Go

Menginstal library klien

go get cloud.google.com/go/datamanager/apiv1@latest

Ikuti petunjuk dalam panduan library klien Go untuk mengetahui informasi selengkapnya.

Java

Menginstal library klien

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

Opsional: Menginstal library utilitas

Selain library klien, Anda dapat menginstal library utilitas untuk membantu tugas umum seperti memformat dan mengenkripsi data untuk penyerapan.

Dalam project Java Anda, deklarasikan dependensi pada library utilitas data-manager-util.

Gradle:

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

Maven:

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

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

Mempelajari contoh kode

Jelajahi contoh kode di subdirektori data-manager-samples atau di GitHub.

Untuk menjalankan contoh:

Clone repositori GitHub di tag v0.4.0:

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

Arahkan ke direktori data-manager-java.
Jalankan contoh dari command line menggunakan tugas run Gradle, dengan meneruskan argumen yang diperlukan. Teruskan argumen --help saat menjalankan contoh untuk mencetak pernyataan penggunaan dengan parameter yang diharapkan.

Misalnya, perintah berikut menjalankan contoh 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.

Node.js

Menginstal library klien

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

Opsional: Menginstal library utilitas

Selain library klien, Anda dapat menginstal library utilitas untuk membantu tugas umum seperti memformat data untuk penyerapan.

Dalam project Node.js, deklarasikan dependensi pada library utilitas @google-ads/datamanager-util:
```
npm install @google-ads/datamanager-util
```
Untuk memformat data, gunakan utilitas UserDataFormatter di project Node.js Anda.

Mempelajari contoh kode

Jelajahi contoh kode di subdirektori samples atau di GitHub.

Untuk menjalankan contoh:

Clone repositori GitHub di tag v0.4.1:

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

Arahkan ke direktori data-manager-node.
Instal dependensi untuk menjalankan contoh:
```
npm install
```
Jalankan contoh, dengan meneruskan argumen yang diperlukan. Teruskan argumen --help saat menjalankan contoh 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.

PHP

Menginstal library klien

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

Opsional: Menginstal library utilitas

Selain library klien, Anda dapat menginstal library utilitas untuk membantu tugas umum seperti memformat data untuk penyerapan.

Dalam file composer.json project PHP Anda di host yang sama, deklarasikan dependensi pada library utilitas:
```
composer require googleads/data-manager-util
```
Untuk memformat data, gunakan utilitas Formatter di project PHP Anda.

Mempelajari contoh kode

Jelajahi contoh kode di subdirektori samples atau di GitHub.

Untuk menjalankan contoh:

Clone repositori GitHub di tag v0.4.0:

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

Arahkan ke direktori data-manager-php/samples.
Instal dependensi untuk menjalankan contoh:
```
composer install
```
Jalankan contoh, dengan meneruskan argumen yang diperlukan. Teruskan argumen --help saat menjalankan contoh untuk mencetak pernyataan penggunaan dengan parameter yang diharapkan.

Misalnya, perintah berikut menjalankan contoh ingest_audience_members dan mencetak pernyataan penggunaan:
```
php audiences/ingest_audience_members.php --help
```

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

Python

Menginstal library klien

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

Opsional: Menginstal library utilitas

Selain library klien, Anda dapat menginstal library utilitas untuk membantu tugas umum seperti memformat dan mengenkripsi data untuk penyerapan.

Dalam project Python Anda, deklarasikan dependensi pada library utilitas google-ads-datamanager-util.

Misalnya, jika menggunakan file requirements.txt dalam project Anda, tambahkan baris berikut ke file:
```
google-ads-datamanager-util==0.4.0
```
Atau instal library utilitas secara langsung:
```
pip install google-ads-datamanager-util==0.4.0
```
Untuk memformat dan mengenkripsi data, gunakan utilitas Formatter dan Encrypter di project Python Anda.

Mempelajari contoh kode

Clone repositori GitHub di tag v0.4.0:

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

Arahkan ke direktori data-manager-python.

Instal dependensi untuk menjalankan contoh:

pip install -r samples/requirements.txt

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

Misalnya, perintah berikut menjalankan contoh ingest_audience_members dan mencetak pernyataan penggunaan:
```
python3 samples/audiences/ingest_audience_members.py --help
```

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

Ruby

Menginstal library klien

Ikuti petunjuk dalam 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 cara mengirim peristiwa.
Pelajari cara men-deploy integrasi ke produksi.
Pelajari dokumentasi referensi REST atau RPC.

Menginstal library klien Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Prasyarat

Langkah-langkah penginstalan

REST

Pengiklan

Partner data

.NET

Menginstal library klien

Opsional: Menginstal library utilitas

Mempelajari contoh kode

Go

Menginstal library klien

Java

Menginstal library klien

Opsional: Menginstal library utilitas

Mempelajari contoh kode

Node.js

Menginstal library klien

Opsional: Menginstal library utilitas

Mempelajari contoh kode

PHP

Menginstal library klien

Opsional: Menginstal library utilitas

Mempelajari contoh kode

Python

Menginstal library klien

Opsional: Menginstal library utilitas

Mempelajari contoh kode

Ruby

Menginstal library klien

Langkah berikutnya

Menginstal library klien