Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Clientbibliothek installieren

So installieren und konfigurieren Sie eine Clientbibliothek oder REST:

Vorbereitung

Führen Sie vor der Installation einer Clientbibliothek 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

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 Ihr 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 Beispiel Datenpartner nur, wenn Sie über einen Partnerlink auf das Betriebskonto zugreifen. Verwenden Sie andernfalls das Beispiel Advertiser.

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: Dienstprogrammbibliothek installieren

Zusätzlich zur Clientbibliothek können Sie die Dienstprogrammbibliothek installieren, um allgemeine Aufgaben wie das Formatieren von Daten für die Aufnahme zu vereinfachen.

Deklarieren Sie in Ihrem .NET-Projekt eine Abhängigkeit von der Dienstprogrammbibliothek Google.Ads.DataManager.Util.
```
dotnet add package Google.Ads.DataManager.Util --version 0.4.0
```
Verwenden Sie zum Formatieren von Daten das Dienstprogramm UserDataFormatter in Ihrem .NET-Projekt.

Codebeispiele durchsuchen

Codebeispiele finden Sie im Unterverzeichnis samples oder auf GitHub.

So führen Sie Beispiele aus:

Klonen Sie das GitHub-Repository mit dem Tag v0.4.0:

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

Rufen Sie das Verzeichnis data-manager-dotnet auf.
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
```

Wenn Sie mit Beispieldaten beginnen möchten, verwenden Sie die Dateien unter samples/sampledata.

Ok

Clientbibliothek installieren

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

Weitere Informationen finden Sie in der Anleitung zur Go-Clientbibliothek.

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: Dienstprogrammbibliothek installieren

Zusätzlich zur Clientbibliothek können Sie die Dienstprogrammbibliothek installieren, um gängige Aufgaben wie das Formatieren und Verschlüsseln von Daten für die Aufnahme zu vereinfachen.

Deklarieren Sie in Ihrem Java-Projekt eine Abhängigkeit von der Dienstprogrammbibliothek 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>

Verwenden Sie zum Formatieren und Verschlüsseln der Daten die Dienstprogramme UserDataFormatter und Encrypter in Ihrem Java-Projekt.

Codebeispiele durchsuchen

Codebeispiele finden Sie im Unterverzeichnis data-manager-samples oder auf GitHub.

So führen Sie Beispiele aus:

Klonen Sie das GitHub-Repository mit dem Tag v0.4.0:

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

Rufen Sie das Verzeichnis data-manager-java auf.
Führen Sie die Beispiele über die Befehlszeile mit der Gradle-Aufgabe run 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 IngestAudienceMembers ausgeführt und eine Nutzungsanweisung ausgegeben:
```
./gradlew data-manager-samples:run \
   --args='IngestAudienceMembers --help'
```

Wenn Sie mit Beispieldaten beginnen möchten, verwenden Sie die Dateien unter data-manager-samples/src/main/resources/sampledata.

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: Dienstprogrammbibliothek installieren

Zusätzlich zur Clientbibliothek können Sie die Dienstprogrammbibliothek installieren, um allgemeine Aufgaben wie das Formatieren von Daten für die Aufnahme zu vereinfachen.

Deklarieren Sie in Ihrem Node.js-Projekt eine Abhängigkeit von der Dienstprogrammbibliothek @google-ads/datamanager-util:
```
npm install @google-ads/datamanager-util
```
Verwenden Sie zum Formatieren von Daten das Dienstprogramm UserDataFormatter in Ihrem Node.js-Projekt.

Codebeispiele durchsuchen

Codebeispiele finden Sie im Unterverzeichnis samples oder auf GitHub.

So führen Sie Beispiele aus:

Klonen Sie das GitHub-Repository mit dem Tag v0.4.1:

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

Rufen Sie das Verzeichnis data-manager-node auf.
Installieren Sie die Abhängigkeiten zum Ausführen der Beispiele:
```
npm install
```
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 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
```

Wenn Sie mit Beispieldaten beginnen möchten, verwenden Sie die Dateien unter samples/sampledata.

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: Dienstprogrammbibliothek installieren

Zusätzlich zur Clientbibliothek können Sie die Dienstprogrammbibliothek installieren, um allgemeine Aufgaben wie das Formatieren von Daten für die Aufnahme zu vereinfachen.

Deklarieren Sie in der Datei composer.json Ihres PHP-Projekts auf demselben Host eine Abhängigkeit von der Dienstprogrammbibliothek:
```
composer require googleads/data-manager-util
```
Verwenden Sie zum Formatieren von Daten das Dienstprogramm Formatter in Ihrem PHP-Projekt.

Codebeispiele durchsuchen

Codebeispiele finden Sie im Unterverzeichnis samples oder auf GitHub.

So führen Sie Beispiele aus:

Klonen Sie das GitHub-Repository mit dem Tag v0.4.0:

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

Rufen Sie das Verzeichnis data-manager-php/samples auf.
Installieren Sie die Abhängigkeiten zum Ausführen der Beispiele:
```
composer install
```
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 erwarteten Parametern auszugeben.

Mit dem folgenden Befehl wird beispielsweise das Beispiel ingest_audience_members ausgeführt und eine Nutzungsanweisung ausgegeben:
```
php audiences/ingest_audience_members.php --help
```

Wenn Sie mit Beispieldaten beginnen möchten, verwenden Sie die Dateien unter samples/sampledata.

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: Dienstprogrammbibliothek installieren

Zusätzlich zur Clientbibliothek können Sie die Dienstprogrammbibliothek installieren, um gängige Aufgaben wie das Formatieren und Verschlüsseln von Daten für die Aufnahme zu vereinfachen.

Deklarieren Sie in Ihrem Python-Projekt eine Abhängigkeit von der Dienstprogrammbibliothek google-ads-datamanager-util.

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.4.0
```
Oder installieren Sie die Dienstprogrammbibliothek direkt:
```
pip install google-ads-datamanager-util==0.4.0
```
Verwenden Sie zum Formatieren und Verschlüsseln der Daten die Dienstprogramme Formatter und Encrypter in Ihrem Python-Projekt.

Codebeispiele durchsuchen

Klonen Sie das GitHub-Repository mit dem Tag v0.4.0:

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

Rufen Sie das Verzeichnis data-manager-python auf.
Installieren Sie die Abhängigkeiten zum Ausführen der Beispiele:
```
pip install -r samples/requirements.txt
```
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 erwarteten Parametern auszugeben.

Mit dem folgenden Befehl wird beispielsweise das Beispiel ingest_audience_members ausgeführt und eine Nutzungsanweisung ausgegeben:
```
python3 samples/audiences/ingest_audience_members.py --help
```

Wenn Sie mit Beispieldaten beginnen möchten, verwenden Sie die Dateien unter samples/sampledata.

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
Integration in der Produktion bereitstellen
Sehen Sie sich die Referenzdokumentation zu REST oder RPC an.

Zurück

API-Zugriff einrichten

Weiter

Agenten-Skills

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: Dienstprogrammbibliothek installieren

Codebeispiele durchsuchen

Ok

Clientbibliothek installieren

Java

Clientbibliothek installieren

Optional: Dienstprogrammbibliothek installieren

Codebeispiele durchsuchen

Node.js

Clientbibliothek installieren

Optional: Dienstprogrammbibliothek installieren

Codebeispiele durchsuchen

PHP

Clientbibliothek installieren

Optional: Dienstprogrammbibliothek installieren

Codebeispiele durchsuchen

Python

Clientbibliothek installieren

Optional: Dienstprogrammbibliothek installieren

Codebeispiele durchsuchen

Ruby

Clientbibliothek installieren

Nächste Schritte

Clientbibliothek installieren