Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Clientbibliothek installieren

So installieren und konfigurieren Sie eine Clientbibliothek oder REST.

Vorbereitung

Bevor Sie eine Clientbibliothek installieren, müssen Sie die Schritte unter API-Zugriff einrichten ausführen, 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

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 Ihres Google Cloud-Projekts.

Kopieren Sie das Beispiel in die Befehlszeile, um die Anfrage zu senden. Verwenden Sie das Datenpartner-Beispiel nur, wenn Sie über einen Partnerlink auf das Betriebskonto zugreifen. Verwenden Sie andernfalls das Advertiser-Beispiel.

Advertiser

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

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

Clientbibliothek installieren

Folgen Sie der Anleitung im Installationsleitfaden für die.NET-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-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 das Dienstprogramm Formatter in Ihrem .NET-Projekt, um Daten zu formatieren.
Codebeispiele finden Sie im Unterverzeichnis samples oder auf GitHub.

Wechseln Sie in das Verzeichnis samples und rufen Sie mit dotnet run die Liste der verfügbaren Beispiele ab.
```
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
```
Um Ihnen den Einstieg mit einigen Beispieldaten zu erleichtern, können Sie die Datei unter samples/sampledata/audience_members_1.csv verwenden.

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

Rufen Sie das Verzeichnis data-manager-java auf.
Erstellen Sie die Hilfsbibliothek und veröffentlichen Sie sie 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 Dienstprogramme UserDataFormatter und Encrypter in Ihrem Java-Projekt, um die Daten zu formatieren und zu verschlüsseln.
Codebeispiele finden Sie im Unterverzeichnis data-manager-samples oder auf GitHub. Verwenden Sie den Gradle-Task run, 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'
```
Um Ihnen den Einstieg mit einigen Beispieldaten zu erleichtern, können Sie die Datei unter data-manager-samples/src/main/resources/sampledata/audience_members_1.csv verwenden.

Node.js

Clientbibliothek installieren

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

Optional: Utility-Bibliothek und Codebeispiele abrufen

Klonen Sie das GitHub-Repository.

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

Rufen Sie das Verzeichnis data-manager-node auf.
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 für die Verwendung mit npm zu packen.
```
npm pack
```
Mit dem Befehl wird ein Archiv mit dem Namen google-ads-datamanager-util-0.2.0.tgz generiert. Notieren Sie sich den Speicherort der Datei, damit Sie ihn in den nächsten Schritten verwenden können.
Deklarieren Sie in Ihrem Node.js-Projekt eine Abhängigkeit von der Data Manager API-Hilfsbibliothek, 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 das UserDataFormatter-Dienstprogramm in Ihrem Node.js-Projekt, um Daten zu formatieren.
Codebeispiele finden Sie im Unterverzeichnis samples oder auf GitHub. Führen Sie die Beispiele mit den folgenden Schritten aus:
1. Rufen Sie das Verzeichnis data-manager-node auf.
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 ingest_audience_members-Beispiel ausgeführt und eine Nutzungsanweisung ausgegeben:
```
npm run ingest-audience-members -w samples -- --help
```
Um Ihnen den Einstieg mit einigen Beispieldaten zu erleichtern, können Sie die Datei unter samples/sampledata/audience_members_1.csv verwenden.

PHP

Clientbibliothek installieren

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

Optional: Utility-Bibliothek und Codebeispiele abrufen

Klonen Sie das GitHub-Repository.

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

Rufen Sie das Verzeichnis data-manager-php auf.
Führen Sie den folgenden Befehl aus, um 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 das Formatter-Dienstprogramm in Ihrem PHP-Projekt, um Daten zu formatieren.
Codebeispiele finden Sie im Unterverzeichnis samples oder auf GitHub. Führen Sie die Beispiele mit den folgenden Schritten aus:
1. Rufen Sie das Verzeichnis samples auf.
2. Führen Sie den folgenden Befehl aus, um 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.
Um Ihnen den Einstieg mit einigen Beispieldaten zu erleichtern, können Sie die Datei unter samples/sampledata/audience_members_1.csv verwenden.

Python

Clientbibliothek installieren

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

Optional: Utility-Bibliothek und Codebeispiele abrufen

Klonen Sie das GitHub-Repository.

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

Rufen Sie das Verzeichnis data-manager-python auf.
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 Dienstprogrammbibliothek. 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 zum Formatieren und Verschlüsseln der Daten die Dienstprogramme Formatter und Encrypter in Ihrem Python-Projekt.
Codebeispiele finden Sie im Unterverzeichnis samples oder auf GitHub. Installieren Sie die erforderlichen Abhängigkeiten, um die 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.

Um Ihnen den Einstieg mit einigen Beispieldaten zu erleichtern, können Sie die Datei unter samples/sampledata/audience_members_1.csv verwenden.

Ruby

Clientbibliothek installieren

Folgen Sie der Anleitung im Installationsleitfaden für die Ruby-Clientbibliothek, 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
Sehen Sie sich die Referenzdokumentation zu REST oder RPC an.

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

Advertiser

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