Clientbibliothek installieren

Hier erfahren Sie, wie Sie eine Clientbibliothek oder REST installieren und konfigurieren.

Vorbereitung

Bevor Sie eine Clientbibliothek installieren, führen Sie die Schritte unter API-Zugriff einrichten aus, einschließlich der Konfiguration von Standardanmeldedaten für Anwendungen (Application Default Credentials, ADC).

Bibliothek installieren

Installieren Sie auf Ihrem lokalen Computer die gewünschte Clientbibliothek:

REST

Wählen Sie den gewünschten Einrichtungsprozess aus:

Ersetzen Sie die Platzhalter im folgenden Beispiel, z. B. OPERATING_ACCOUNT_PRODUCT, OPERATING_ACCOUNT_ID, und AUDIENCE_ID, durch die Werte für Ihr Konto und Ziel.
Ersetzen Sie PROJECT_ID durch die ID Ihrer Google Cloud.

Kopieren Sie das Beispiel in die Befehlszeile, um die Anfrage zu senden.

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

Clientbibliothek installieren

Folgen Sie der Anleitung im .NET-Clientbibliothek-Installations leitfaden, um Ihrem Projekt eine Abhängigkeit von der Clientbibliothek hinzuzufügen.

Optional: Utility-Bibliothek und Codebeispiele abrufen

Klonen Sie das GitHub Repository.

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

Deklarieren Sie in Ihrem .NET-Projekt eine ProjectReference Abhängigkeit von der Utility-Bibliothek. Ersetzen Sie PATH_TO_UTILITY_LIBRARY durch den Speicherort, an dem Sie das data-manager-dotnet Repository geklont haben.
```
<ProjectReference Include="PATH_TO_UTILITY_LIBRARY\Google.Ads.DataManager.Util\src\Google.Ads.DataManager.Util.csproj" />
```
Verwenden Sie die Formatter Utility in Ihrem .NET-Projekt, um Daten zu formatieren.
Codebeispiele finden Sie im samples Unterverzeichnis oder auf GitHub.

Wechseln Sie zum Verzeichnis samples und verwenden Sie dotnet run, um die Liste der verfügbaren Beispiele abzurufen.
```
dotnet run
```
Übergeben Sie beim Ausführen eines Beispiels das Argument --help, um eine Nutzungs anweisung mit den erwarteten Parametern auszugeben.
```
dotnet run -- ingest-audience-members --help
```
Die Datei samples/sampledata/audience_members_1.csv enthält einige Beispieldaten, die Ihnen den Einstieg erleichtern.

Java

Clientbibliothek installieren

Folgen Sie der Anleitung im Installationsleitfaden für die Java-Clientbibliothek, um Ihrem Projekt eine Abhängigkeit von der Clientbibliothek hinzuzufügen.

Optional: Utility-Bibliothek und Codebeispiele abrufen

Klonen Sie das GitHub Repository.

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

Wechseln Sie zum data-manager-java Verzeichnis.
Erstellen und veröffentlichen Sie die Utility-Bibliothek in Ihrem lokalen Maven-Repository.
```
./gradlew data-manager-util:install
```

Deklarieren Sie in Ihrem Java-Projekt eine Abhängigkeit von der Utility-Bibliothek.

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>

Verwenden Sie die UserDataFormatter und Encrypter Utilities in Ihrem Java Projekt, um die Daten zu formatieren und zu verschlüsseln.
Codebeispiele finden Sie im data-manager-samples Unterverzeichnis oder auf GitHub. Verwenden Sie die Gradle-run-Aufgabe, um ein Beispiel über die Befehlszeile auszuführen.

Mit dem folgenden Befehl wird beispielsweise das IngestAudienceMembers Beispiel ausgeführt und eine Nutzungsanweisung ausgegeben:
```
./gradlew data-manager-samples:run \
   --args='IngestAudienceMembers --help'
```
Die Datei data-manager-samples/src/main/resources/sampledata/audience_members_1.csv enthält einige Beispieldaten, die Ihnen den Einstieg erleichtern.

Node.js

Clientbibliothek installieren

Folgen Sie der Anleitung im Installationsleitfaden für die Node.js-Clientbibliothek, um Ihrem Projekt eine Abhängigkeit von der @google-ads/datamanager Clientbibliothek hinzuzufügen.

Optional: Utility-Bibliothek und Codebeispiele abrufen

Klonen Sie das GitHub Repository.

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

Wechseln Sie zum data-manager-node Verzeichnis.
Führen Sie den folgenden Befehl aus, um die Abhängigkeiten zu installieren.
```
npm install
```
Wechseln Sie zum util Verzeichnis.
```
cd util
```
Führen Sie den folgenden Befehl aus, um die Utility-Bibliothek zu kompilieren und in eine .tgz Datei zu packen, die mit npm verwendet werden kann.
```
npm pack
```
Der Befehl generiert ein Archiv mit dem Namen google-ads-datamanager-util-0.2.0.tgz. Notieren Sie sich den Speicherort der Datei, damit Sie sie in den nächsten Schritten verwenden können.
Deklarieren Sie in Ihrem Node.js-Projekt eine Abhängigkeit von der Data Manager API Utility-Bibliothek, indem Sie einen dependencies Eintrag für den vollständigen Pfad und Dateinamen der google-ads-datamanager-util-0.2.0.tgz Datei hinzufügen.
```
{
   "dependencies": {
      ...
      "@google-ads/data-manager-util": "file:PATH_TO_UTILITY_LIBRARY/google-ads-datamanager-util-0.2.0.tgz",
      ...
   }
}
```
Verwenden Sie die UserDataFormatter Utility in Ihrem Node.js Projekt, um Daten zu formatieren.
Codebeispiele finden Sie im samples Unterverzeichnis oder auf GitHub. Führen Sie die Beispiele so aus:
1. Wechseln Sie zum data-manager-node Verzeichnis.
2. Führen Sie die Beispiele aus und übergeben Sie alle erforderlichen Argumente. Übergeben Sie beim Ausführen eines Beispiels das --help Argument, um eine Nutzungsanweisung mit den erwarteten Parametern auszugeben.
  
  Mit dem folgenden Befehl wird beispielsweise das ingest_audience_members Beispiel ausgeführt und eine Nutzungsanweisung ausgegeben:
```
npm run ingest-audience-members -w samples -- --help
```
Die Datei samples/sampledata/audience_members_1.csv enthält einige Beispieldaten, die Ihnen den Einstieg erleichtern.

PHP

Clientbibliothek installieren

Folgen Sie der Anleitung im Installationsleitfaden für die PHP-Clientbibliothek, um Ihrem Projekt eine Abhängigkeit von der googleads/data-manager Clientbibliothek hinzuzufügen.

Optional: Utility-Bibliothek und Codebeispiele abrufen

Klonen Sie das GitHub Repository.

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

Wechseln Sie zum data-manager-php Verzeichnis.
Führen Sie den folgenden Befehl aus, um die Abhängigkeiten für die Bibliothek aufzulösen:
```
composer update --prefer-dist
```
Deklarieren Sie in der Datei composer.json Ihres PHP-Projekts auf demselben Host eine Abhängigkeit von der Utility-Bibliothek. Gehen Sie dazu so vor:
1. Fügen Sie im Abschnitt repositories einen Eintrag hinzu, der auf den Speicherort des Verzeichnisses data-manager-php verweist.
```
"repositories" : [
   {
      "type" : "path",
      "url" : "PATH_TO_UTILITY_LIBRARY"
   }
]
```
2. Deklarieren Sie eine Abhängigkeit von der Utility-Bibliothek.
```
"require": {
   "googleads/data-manager-util": "@dev"
}
```
Verwenden Sie die Formatter Utility in Ihrem PHP-Projekt, um Daten zu formatieren.
Codebeispiele finden Sie im samples Unterverzeichnis oder auf GitHub. Führen Sie die Beispiele so aus:
1. Wechseln Sie zum samples Verzeichnis.
2. Führen Sie den folgenden Befehl aus, um die Abhängigkeiten für die Bibliothek aufzulösen:
```
composer update --prefer-dist
```
3. Führen Sie die Beispiele aus und übergeben Sie alle erforderlichen Argumente. Übergeben Sie beim Ausführen eines Beispiels das --help Argument, um eine Nutzungsanweisung mit den erwarteten Parametern auszugeben.
Die Datei samples/sampledata/audience_members_1.csv enthält einige Beispieldaten, die Ihnen den Einstieg erleichtern.

Python

Clientbibliothek installieren

Folgen Sie der Anleitung im Installationsleitfaden für die Python-Clientbibliothek, um Ihrem Projekt eine Abhängigkeit von der google-ads-datamanager Clientbibliothek hinzuzufügen.

Optional: Utility-Bibliothek und Codebeispiele abrufen

Klonen Sie das GitHub Repository.

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

Wechseln Sie zum data-manager-python Verzeichnis.
Führen Sie den folgenden Befehl aus, um die Utility-Bibliothek in Ihrer Python Umgebung zu installieren:
```
pip install .
```
Deklarieren Sie in Ihrem Python-Projekt eine Abhängigkeit von der Utility-Bibliothek. Wenn Sie beispielsweise eine requirements.txt-Datei in Ihrem Projekt verwenden, fügen Sie der Datei die folgende Zeile hinzu:
```
google-ads-data-manager-util=0.2.0
```
Verwenden Sie die Formatter und Encrypter Utilities in Ihrem Python-Projekt, um die Daten zu formatieren und zu verschlüsseln.
Codebeispiele finden Sie im samples Unterverzeichnis oder auf GitHub. Installieren Sie die erforderlichen Abhängigkeiten, um Beispiele auszuführen:
```
pip install .[samples]
```
Übergeben Sie beim Ausführen eines Beispiels das Argument --help, um eine Nutzungs anweisung mit den erwarteten Parametern auszugeben.

Die Datei samples/sampledata/audience_members_1.csv enthält einige Beispieldaten, die Ihnen den Einstieg erleichtern.

Ruby

Clientbibliothek installieren

Folgen Sie der Anleitung im Installationsleitfaden für die Ruby-Clientbibliothek guide, um Ihrem Projekt eine Abhängigkeit von der Clientbibliothek hinzuzufügen.

Nächste Schritte

Weitere Informationen zum Senden von Zielgruppendaten.
Weitere Informationen zum Senden von Ereignissen.
Referenzdokumentation zu REST oder RPC ansehen

Zurück

API-Zugriff einrichten

Clientbibliothek installieren Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Vorbereitung

Bibliothek installieren

REST

.NET

Clientbibliothek installieren

Optional: Utility-Bibliothek und Codebeispiele abrufen

Java

Clientbibliothek installieren

Optional: Utility-Bibliothek und Codebeispiele abrufen

Node.js

Clientbibliothek installieren

Optional: Utility-Bibliothek und Codebeispiele abrufen

PHP

Clientbibliothek installieren

Optional: Utility-Bibliothek und Codebeispiele abrufen

Python

Clientbibliothek installieren

Optional: Utility-Bibliothek und Codebeispiele abrufen

Ruby

Clientbibliothek installieren

Nächste Schritte

Clientbibliothek installieren