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 Anda, instal library klien pilihan Anda:

REST

  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. 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: 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 Anda, 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. Telusuri contoh kode di subdirektori samples atau di GitHub.

    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 contoh, gunakan file di samples/sampledata/audience_members_1.csv.

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 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. Buka direktori data-manager-java.

  3. Build 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. Telusuri contoh kode di subdirektori data-manager-samples atau di GitHub. Untuk menjalankan contoh dari command line, gunakan tugas run Gradle.

    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 contoh, gunakan file di data-manager-samples/src/main/resources/sampledata/audience_members_1.csv.

Node.js

Menginstal library klien

Ikuti petunjuk dalam panduan penginstalan library klien Node.js untuk menambahkan dependensi ke @google-ads/datamanager 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-node.git

  2. Buka 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 menghasilkan arsip bernama google-ads-datamanager-util-0.2.0.tgz. Catat lokasi file agar Anda dapat menggunakannya pada langkah berikutnya.

  6. Dalam project Node.js Anda, deklarasikan dependensi pada library utilitas Data Manager API dengan menambahkan entri dependencies untuk jalur dan nama file lengkap dari 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. Telusuri contoh kode di subdirektori samples atau di GitHub. Jalankan contoh menggunakan langkah-langkah berikut:

    1. Buka direktori data-manager-node.

    2. 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 contoh, 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 googleads/data-manager 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-php.git

  2. Buka direktori data-manager-php.

  3. Jalankan perintah berikut untuk mengatasi dependensi untuk 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. Telusuri contoh kode di subdirektori samples atau di GitHub. Jalankan contoh menggunakan langkah-langkah berikut:

    1. Buka direktori samples.

    2. Jalankan perintah berikut untuk mengatasi dependensi untuk library:

      composer update --prefer-dist

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

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

Python

Menginstal library klien

Ikuti petunjuk dalam panduan penginstalan library klien Python 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-python.git

  2. Buka direktori data-manager-python.

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

    pip install .

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

    google-ads-datamanager-util=0.2.0

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

  6. Telusuri 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 contoh, gunakan file di samples/sampledata/audience_members_1.csv.

Ruby

Menginstal library klien

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

Langkah berikutnya

Sebelumnya
Menyiapkan akses API