Instalowanie biblioteki klienta

Poniżej znajdziesz instrukcje instalacji i konfigurowania biblioteki klienta lub interfejsu 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 dane logowania aplikacji (ADC).

Instalowanie biblioteki

Zainstaluj na komputerze lokalnym wybraną bibliotekę klienta:

REST

Wybierz typ procesu konfiguracji, który chcesz przeprowadzić:

Reklamodawca Partner danych

1. Zastąp symbole zastępcze w tym przykładzie, np. OPERATING_ACCOUNT_PRODUCT, OPERATING_ACCOUNT_ID i AUDIENCE_ID, wartościami odpowiednimi dla Twojego konta i miejsca docelowego.
2. Zastąp PROJECT_ID identyfikatorem Google Cloud.

3. Skopiuj przykład do wiersza poleceń, aby wysłać żądanie.

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

Instalowanie biblioteki klienta

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

Opcjonalnie: pobierz bibliotekę narzędzi i przykłady kodu.

1. Sklonuj repozytorium GitHub.

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

2. W projekcie .NET zadeklaruj ProjectReference zależność od biblioteki narzędzi. Zastąp PATH_TO_UTILITY_LIBRARY lokalizacją, w której sklonowano repozytorium data-manager-dotnet.

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

3. Aby sformatować dane, użyj narzędzia Formatter w projekcie .NET.

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

   Przejdź do katalogu samples i użyj polecenia dotnet run, aby uzyskać listę dostępnych próbek.

   dotnet run
   

   Podaj argument --help podczas uruchamiania przykładu, 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, użyj pliku dostępnego pod adresem samples/sampledata/audience_members_1.csv.

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: pobierz bibliotekę narzędzi i przykłady kodu.

1. Sklonuj repozytorium GitHub.

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

2. Przejdź do katalogu data-manager-java.

3. Skompiluj i opublikuj bibliotekę narzędziową w lokalnym repozytorium Maven.

   ./gradlew data-manager-util:install
   

4. W projekcie Java zadeklaruj zależność od biblioteki narzędziowej.

   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. Aby sformatować i zaszyfrować dane, użyj narzędzi UserDataFormatter i Encrypter w projekcie Java.

6. Przejrzyj przykłady kodu w podkatalogu data-manager-samples lub na GitHubie. Aby uruchomić przykład z wiersza poleceń, użyj zadania Gradle run.

   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, użyj pliku dostępnego pod adresem data-manager-samples/src/main/resources/sampledata/audience_members_1.csv.

Node.js

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 Node.js.

Opcjonalnie: pobierz bibliotekę narzędzi i przykłady kodu.

1. Sklonuj repozytorium GitHub.

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

2. Przejdź do katalogu data-manager-node.

3. Aby zainstalować zależności, uruchom to polecenie.

   npm install
   

4. Przejdź do katalogu util.

   cd util
   

5. Uruchom to polecenie, aby skompilować i spakować bibliotekę narzędziową do pliku .tgz do użycia z npm.

   npm pack
   

   Polecenie tworzy archiwum o nazwie google-ads-datamanager-util-0.2.0.tgz. Zapisz lokalizację pliku, aby móc go użyć w następnych krokach.

6. W projekcie Node.js zadeklaruj zależność od biblioteki narzędziowej Data Manager API, dodając wpis dependencies dla pełnej ścieżki i nazwy pliku 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",
         ...
      }
   }
   

   Aby sformatować dane, użyj narzędzia UserDataFormatter w projekcie Node.js.

7. Przejrzyj przykłady kodu w podkatalogu samples lub na GitHubie. Uruchom przykłady, wykonując te czynności:

   1. Przejdź do katalogu data-manager-node.

   2. Uruchom przykłady, przekazując wymagane argumenty. Podczas uruchamiania przykładu przekaż argument --help, 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, użyj pliku dostępnego pod adresem samples/sampledata/audience_members_1.csv.

PHP

Instalowanie biblioteki klienta

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

Opcjonalnie: pobierz bibliotekę narzędzi i przykłady kodu.

1. Sklonuj repozytorium GitHub.

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

2. Przejdź do katalogu data-manager-php.

3. Aby rozwiązać zależności biblioteki, uruchom to polecenie:

   composer update --prefer-dist
   

4. W pliku composer.json projektu PHP na tym samym hoście zadeklaruj zależność od biblioteki narzędziowej, wykonując te czynności:

   1. Dodaj wpis w sekcji repositories, który wskazuje lokalizację katalogu data-manager-php.

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

   2. Zadeklaruj zależność od biblioteki narzędziowej.

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

   Aby sformatować dane, użyj narzędzia Formatter w projekcie PHP.

5. Przejrzyj przykłady kodu w podkatalogu samples lub na GitHubie. Uruchom przykłady, wykonując te czynności:

   1. Przejdź do katalogu samples.

   2. Aby rozwiązać zależności biblioteki, uruchom to polecenie:

      composer update --prefer-dist
      

   3. Uruchom przykłady, przekazując wymagane argumenty. Podczas uruchamiania przykładu przekaż argument --help, aby wydrukować instrukcję użycia z oczekiwanymi parametrami.

   Aby ułatwić Ci rozpoczęcie pracy z przykładowymi danymi, użyj pliku dostępnego pod adresem samples/sampledata/audience_members_1.csv.

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: pobierz bibliotekę narzędzi i przykłady kodu.

1. Sklonuj repozytorium GitHub.

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

2. Przejdź do katalogu data-manager-python.

3. Aby zainstalować bibliotekę narzędziową w środowisku Pythona, uruchom to polecenie:

   pip install .
   

4. W projekcie w Pythonie zadeklaruj zależność od biblioteki narzędzi. Jeśli na przykład w projekcie używasz pliku requirements.txt, dodaj do niego ten wiersz:

   google-ads-data-manager-util=0.2.0
   

5. Aby sformatować i zaszyfrować dane, użyj narzędzi Formatter i Encrypter w projekcie w Pythonie.

6. Przejrzyj przykłady kodu w podkatalogu samples lub na GitHubie. Aby uruchomić przykłady, zainstaluj niezbędne zależności:

   pip install .[samples]
   

   Podaj argument --help podczas uruchamiania przykładu, aby wydrukować instrukcję użycia z oczekiwanymi parametrami.

   Aby ułatwić Ci rozpoczęcie pracy z przykładowymi danymi, użyj pliku dostępnego pod adresem samples/sampledata/audience_members_1.csv.

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 przesyłaniu danych o odbiorcach.
• Dowiedz się więcej o wysyłaniu zdarzeń.
• Przejrzyj dokumentację interfejsu REST lub RPC.

Wskazówka: aby wypróbować dowolną metodę, otwórz dokumentację interfejsu REST i kliknij przycisk API na pasku narzędzi na stronie metody. Więcej informacji znajdziesz w artykule Wyświetlanie narzędzia API Explorer i wykonywanie metody.