Clientbibliothek installieren

So installieren und konfigurieren Sie eine Clientbibliothek oder REST.

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

Installationsschritte

Installieren Sie auf Ihrem lokalen Computer die Clientbibliothek Ihrer Wahl:

REST

Aktualisieren Sie die Platzhalter im folgenden Beispiel, z. B. OPERATING_ACCOUNT_PRODUCT, OPERATING_ACCOUNT_ID, und AUDIENCE_ID, mit den Werten 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. Verwenden Sie das Beispiel Datenpartner nur, wenn Sie über einen Partnerlink auf das Betriebskonto zugreifen. Verwenden Sie andernfalls das Beispiel Werbetreibender.

Werbetreibender

#!/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": [
    {
      "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

Datenpartner

#!/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": [
    {
      "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

Klone 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 Utility Formatter 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 das Argument --help, wenn Sie ein Beispiel ausführen, um eine Nutzungsanweisung 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

Klone das GitHub Repository.

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

Wechseln Sie zum Verzeichnis data-manager-java.
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 Utilities UserDataFormatter und Encrypter 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-Aufgabe run, um ein Beispiel über die Befehlszeile auszuführen.

Mit dem folgenden Befehl wird beispielsweise das Beispiel IngestAudienceMembers 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

Klone das GitHub Repository.

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

Wechseln Sie zum Verzeichnis data-manager-node.
Führen Sie den folgenden Befehl aus, um die Abhängigkeiten zu installieren.
```
npm install
```
Wechseln Sie zum Verzeichnis util.
```
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 Utility-Bibliothek der Data Manager API, indem Sie einen dependencies-Eintrag für den vollständigen Pfad und Dateinamen der Datei google-ads-datamanager-util-0.2.0.tgz hinzufügen.
```
{
   "dependencies": {
      ...
      "@google-ads/data-manager-util": "file:PATH_TO_UTILITY_LIBRARY/google-ads-datamanager-util-0.2.0.tgz",
      ...
   }
}
```
Verwenden Sie die Utility UserDataFormatter in Ihrem Node.js-Projekt, um Daten zu formatieren.
Codebeispiele finden Sie im samples Unterverzeichnis oder auf GitHub. So führen Sie die Beispiele aus:
1. Wechseln Sie zum Verzeichnis data-manager-node.
2. Führen Sie die Beispiele aus und übergeben Sie alle erforderlichen Argumente. Übergeben Sie das Argument --help, wenn Sie ein Beispiel ausführen, um eine Nutzungsanweisung mit den erwarteten Parametern auszugeben.
  
  Mit dem folgenden Befehl wird beispielsweise das Beispiel ingest_audience_members 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

Klone das GitHub Repository.

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

Wechseln Sie zum Verzeichnis data-manager-php.
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 Utility Formatter in Ihrem PHP-Projekt, um Daten zu formatieren.
Codebeispiele finden Sie im samples Unterverzeichnis oder auf GitHub. So führen Sie die Beispiele aus:
1. Wechseln Sie zum Verzeichnis samples.
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 das Argument --help, wenn Sie ein Beispiel ausführen, 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

Klone das GitHub Repository.

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

Wechseln Sie zum Verzeichnis data-manager-python.
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-datamanager-util=0.2.0
```
Verwenden Sie die Utilities Formatter und Encrypter 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 das Argument --help, wenn Sie ein Beispiel ausführen, 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.

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

Zurück

API-Zugriff einrichten

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

Vorbereitung

Installationsschritte

REST

Werbetreibender

Datenpartner

.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