Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

Instalowanie biblioteki klienta

Poniżej znajdziesz instrukcje instalacji i konfigurowania biblioteki klienta lub REST.

Wymagania wstępne

Przed zainstalowaniem biblioteki klienta wykonaj czynności opisane w artykule Konfigurowanie dostępu do interfejsu API, w tym skonfiguruj domyślne uwierzytelnianie aplikacji (ADC).

Instrukcje instalacji

Zainstaluj na komputerze lokalnym wybraną bibliotekę klienta:

REST

Zaktualizuj symbole zastępcze w tym przykładzie, np. OPERATING_ACCOUNT_PRODUCT, OPERATING_ACCOUNT_ID i AUDIENCE_ID, podając wartości dla swojego konta i miejsca docelowego.
Zastąp PROJECT_ID identyfikatorem Google Cloud.

Skopiuj przykład do wiersza poleceń, aby wysłać żądanie. Wzoru Dostawca danych używaj tylko wtedy, gdy uzyskujesz dostęp do konta operacyjnego za pomocą linku partnera. W przeciwnym razie użyj przykładowego pliku Reklamodawca.

Reklamodawca

#!/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

Dostawca danych

#!/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

Instalowanie biblioteki klienta

Aby dodać zależność do biblioteki klienta w projekcie, postępuj zgodnie z instrukcjami w przewodniku instalacji biblioteki klienta.NET.

Opcjonalnie: zainstaluj bibliotekę narzędzi

Oprócz biblioteki klienta możesz zainstalować bibliotekę narzędzi, która ułatwia wykonywanie typowych zadań, takich jak formatowanie danych na potrzeby wczytywania.

W projekcie .NET zadeklaruj zależność od biblioteki narzędziowej Google.Ads.DataManager.Util.
```
dotnet add package Google.Ads.DataManager.Util --version 0.4.0
```
Aby sformatować dane, użyj narzędzia UserDataFormatter w projekcie .NET.

Przeglądanie przykładowych fragmentów kodu

Przejrzyj przykłady kodu w podkatalogu samples lub na GitHubie.

Aby uruchomić przykłady:

Sklonuj repozytorium GitHub w tagu v0.4.0:

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

Przejdź do katalogu data-manager-dotnet.
Przejdź do katalogu samples i użyj polecenia dotnet run, aby uzyskać listę dostępnych próbek.
```
dotnet run
```
Podczas uruchamiania przykładu przekaż argument --help, aby wydrukować instrukcję użycia z oczekiwanymi parametrami.
```
dotnet run -- ingest-audience-members --help
```

Aby ułatwić Ci rozpoczęcie pracy z przykładowymi danymi, skorzystaj z plików dostępnych na stronie samples/sampledata.

Go

Instalowanie biblioteki klienta

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

Więcej informacji znajdziesz w przewodniku po bibliotece klienta Go.

Java

Instalowanie biblioteki klienta

Aby dodać zależność do biblioteki klienta w projekcie, postępuj zgodnie z instrukcjami w przewodniku instalacji biblioteki klienta w języku Java.

Opcjonalnie: zainstaluj bibliotekę narzędzi

Oprócz biblioteki klienta możesz zainstalować bibliotekę narzędzi, która ułatwia wykonywanie typowych zadań, takich jak formatowanie i szyfrowanie danych na potrzeby ich pozyskiwania.

W projekcie w języku Java zadeklaruj zależność od biblioteki narzędziowej 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>

Aby sformatować i zaszyfrować dane, użyj narzędzi UserDataFormatter i Encrypter w projekcie Java.

Przeglądanie przykładowych fragmentów kodu

Przejrzyj przykłady kodu w podkatalogu data-manager-samples lub na GitHubie.

Aby uruchomić przykłady:

Sklonuj repozytorium GitHub w tagu v0.4.0:

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

Przejdź do katalogu data-manager-java.
Uruchom przykłady z wiersza poleceń za pomocą zadania Gradle run, przekazując wymagane argumenty. Podczas uruchamiania próbki przekaż argument --help, aby wydrukować instrukcję użycia z oczekiwanymi parametrami.

Na przykład to polecenie uruchamia przykład IngestAudienceMembers i wyświetla instrukcję użycia:
```
./gradlew data-manager-samples:run \
   --args='IngestAudienceMembers --help'
```

Aby ułatwić Ci rozpoczęcie pracy z przykładowymi danymi, skorzystaj z plików dostępnych na stronie data-manager-samples/src/main/resources/sampledata.

Node.js

Instalowanie biblioteki klienta

Aby dodać do projektu zależność od biblioteki klienta @google-ads/datamanager, postępuj zgodnie z instrukcjami w przewodniku instalacji biblioteki klienta Node.js.

Opcjonalnie: zainstaluj bibliotekę narzędzi

Oprócz biblioteki klienta możesz zainstalować bibliotekę narzędzi, która ułatwia wykonywanie typowych zadań, takich jak formatowanie danych na potrzeby wczytywania.

W projekcie Node.js zadeklaruj zależność od biblioteki narzędziowej @google-ads/datamanager-util:
```
npm install @google-ads/datamanager-util
```
Aby sformatować dane, użyj narzędzia UserDataFormatter w projekcie Node.js.

Przeglądanie przykładowych fragmentów kodu

Przejrzyj przykłady kodu w podkatalogu samples lub na GitHubie.

Aby uruchomić przykłady:

Sklonuj repozytorium GitHub w tagu v0.4.1:

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

Przejdź do katalogu data-manager-node.
Zainstaluj zależności potrzebne do uruchomienia przykładów:
```
npm install
```
Uruchom przykłady, przekazując wymagane argumenty. Podaj argument --help podczas uruchamiania próbki, aby wydrukować instrukcję użycia z oczekiwanymi parametrami.

Na przykład to polecenie uruchamia przykład ingest-audience-members i wyświetla instrukcję użycia:
```
npm run ingest-audience-members -w samples -- --help
```

Aby ułatwić Ci rozpoczęcie pracy z przykładowymi danymi, skorzystaj z plików dostępnych na stronie samples/sampledata.

PHP

Instalowanie biblioteki klienta

Postępuj zgodnie z instrukcjami w przewodniku instalacji biblioteki klienta PHP, aby dodać zależność do biblioteki klienta googleads/data-manager w projekcie.

Opcjonalnie: zainstaluj bibliotekę narzędzi

Oprócz biblioteki klienta możesz zainstalować bibliotekę narzędzi, która ułatwia wykonywanie typowych zadań, takich jak formatowanie danych na potrzeby wczytywania.

W pliku composer.json projektu PHP na tym samym hoście zadeklaruj zależność od biblioteki narzędzi:
```
composer require googleads/data-manager-util
```
Aby sformatować dane, użyj narzędzia Formatter w projekcie PHP.

Przeglądanie przykładowych fragmentów kodu

Przejrzyj przykłady kodu w podkatalogu samples lub na GitHubie.

Aby uruchomić przykłady:

Sklonuj repozytorium GitHub w tagu v0.4.0:

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

Przejdź do katalogu data-manager-php/samples.
Zainstaluj zależności potrzebne do uruchomienia przykładów:
```
composer install
```
Uruchom przykłady, przekazując wymagane argumenty. Podaj argument --help podczas uruchamiania próbki, aby wydrukować instrukcję użycia z oczekiwanymi parametrami.

Na przykład to polecenie uruchamia przykład ingest_audience_members i wyświetla instrukcję użycia:
```
php audiences/ingest_audience_members.php --help
```

Aby ułatwić Ci rozpoczęcie pracy z przykładowymi danymi, skorzystaj z plików dostępnych na stronie samples/sampledata.

Python

Instalowanie biblioteki klienta

Aby dodać zależność do biblioteki klienta google-ads-datamanager w projekcie, postępuj zgodnie z instrukcjami w przewodniku instalacji biblioteki klienta w Pythonie.

Opcjonalnie: zainstaluj bibliotekę narzędzi

Oprócz biblioteki klienta możesz zainstalować bibliotekę narzędzi, która ułatwia wykonywanie typowych zadań, takich jak formatowanie i szyfrowanie danych na potrzeby ich pozyskiwania.

W projekcie w Pythonie zadeklaruj zależność od biblioteki narzędziowej google-ads-datamanager-util.

Jeśli na przykład w projekcie używasz pliku requirements.txt, dodaj do niego ten wiersz:
```
google-ads-datamanager-util==0.4.0
```
Możesz też zainstalować bibliotekę narzędzi bezpośrednio:
```
pip install google-ads-datamanager-util==0.4.0
```
Aby sformatować i zaszyfrować dane, użyj narzędzi Formatter i Encrypter w projekcie w Pythonie.

Przeglądanie przykładowych fragmentów kodu

Sklonuj repozytorium GitHub w tagu v0.4.0:

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

Przejdź do katalogu data-manager-python.
Zainstaluj zależności potrzebne do uruchomienia przykładów:
```
pip install -r samples/requirements.txt
```
Uruchom przykłady, przekazując wymagane argumenty. Podaj argument --help podczas uruchamiania próbki, aby wydrukować instrukcję użycia z oczekiwanymi parametrami.

Na przykład to polecenie uruchamia przykład ingest_audience_members i wyświetla instrukcję użycia:
```
python3 samples/audiences/ingest_audience_members.py --help
```

Aby ułatwić Ci rozpoczęcie pracy z przykładowymi danymi, skorzystaj z plików dostępnych na stronie samples/sampledata.

Ruby

Instalowanie biblioteki klienta

Aby dodać zależność do biblioteki klienta w projekcie, postępuj zgodnie z instrukcjami w przewodniku instalacji biblioteki klienta Ruby.

Dalsze kroki

Dowiedz się więcej o wysyłaniu danych o odbiorcach.
Dowiedz się więcej o wysyłaniu zdarzeń.
Przejrzyj dokumentację interfejsu REST lub RPC.

Wstecz

Konfigurowanie dostępu do interfejsu API

Dalej

Umiejętności agenta

Instalowanie biblioteki klienta Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Wymagania wstępne

Instrukcje instalacji

REST

Reklamodawca

Dostawca danych

.NET

Instalowanie biblioteki klienta

Opcjonalnie: zainstaluj bibliotekę narzędzi

Przeglądanie przykładowych fragmentów kodu

Go

Instalowanie biblioteki klienta

Java

Instalowanie biblioteki klienta

Opcjonalnie: zainstaluj bibliotekę narzędzi

Przeglądanie przykładowych fragmentów kodu

Node.js

Instalowanie biblioteki klienta

Opcjonalnie: zainstaluj bibliotekę narzędzi

Przeglądanie przykładowych fragmentów kodu

PHP

Instalowanie biblioteki klienta

Opcjonalnie: zainstaluj bibliotekę narzędzi

Przeglądanie przykładowych fragmentów kodu

Python

Instalowanie biblioteki klienta

Opcjonalnie: zainstaluj bibliotekę narzędzi

Przeglądanie przykładowych fragmentów kodu

Ruby

Instalowanie biblioteki klienta

Dalsze kroki

Instalowanie biblioteki klienta