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

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

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.NET-Clientbibliotheken, um Ihrem Projekt eine Abhängigkeit von der Clientbibliothek hinzuzufügen.

Optional: Utility Library installieren

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

Deklarieren Sie in Ihrem .NET-Projekt eine Abhängigkeit von der Google.Ads.DataManager.Util-Hilfsbibliothek.
```
dotnet add package Google.Ads.DataManager.Util --version 0.4.0
```
Verwenden Sie das UserDataFormatter-Dienstprogramm in Ihrem .NET-Projekt, um Daten zu formatieren.

Codebeispiele durchsuchen

Sehen Sie sich die Codebeispiele im Unterverzeichnis samples oder auf GitHub an.

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
```

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

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 zur Installation der Java-Clientbibliothek, um Ihrem Projekt eine Abhängigkeit von der Clientbibliothek hinzuzufügen.

Optional: Utility Library installieren

Zusätzlich zur Clientbibliothek können Sie die Utility-Bibliothek installieren, um allgemeine Aufgaben wie das Formatieren und Verschlüsseln von Daten für die Aufnahme zu erleichtern.

Deklarieren Sie in Ihrem Java-Projekt eine Abhängigkeit von der data-manager-util-Hilfsbibliothek.

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 die Dienstprogramme UserDataFormatter und Encrypter in Ihrem Java-Projekt, um die Daten zu formatieren und zu verschlüsseln.

Codebeispiele durchsuchen

Sehen Sie sich die Codebeispiele im Unterverzeichnis data-manager-samples oder auf GitHub an.

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 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 Dateien unter data-manager-samples/src/main/resources/sampledata verwenden.

Node.js

Clientbibliothek installieren

Folgen Sie der Anleitung zur Installation der Node.js-Clientbibliothek, um Ihrem Projekt eine Abhängigkeit von der @google-ads/datamanager-Clientbibliothek hinzuzufügen.

Optional: Utility Library installieren

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

Deklarieren Sie in Ihrem Node.js-Projekt eine Abhängigkeit von der Utility-Bibliothek @google-ads/datamanager-util:
```
npm install @google-ads/datamanager-util
```
Verwenden Sie das UserDataFormatter-Dienstprogramm in Ihrem Node.js-Projekt, um Daten zu formatieren.

Codebeispiele durchsuchen

Sehen Sie sich die Codebeispiele im Unterverzeichnis samples oder auf GitHub an.

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 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 Dateien unter samples/sampledata verwenden.

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 Library installieren

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

Deklarieren Sie in der Datei composer.json Ihres PHP-Projekts auf demselben Host eine Abhängigkeit von der Utility-Bibliothek:
```
composer require googleads/data-manager-util
```
Verwenden Sie das Dienstprogramm Formatter in Ihrem PHP-Projekt, um Daten zu formatieren.

Codebeispiele durchsuchen

Sehen Sie sich die Codebeispiele im Unterverzeichnis samples oder auf GitHub an.

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 den erwarteten Parametern auszugeben.

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

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

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 Library installieren

Zusätzlich zur Clientbibliothek können Sie die Utility-Bibliothek installieren, um allgemeine Aufgaben wie das Formatieren und Verschlüsseln von Daten für die Aufnahme zu erleichtern.

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

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 den erwarteten Parametern auszugeben.

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

Um Ihnen den Einstieg mit einigen Beispieldaten zu erleichtern, können Sie die Dateien unter samples/sampledata 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 REST- oder RPC-Referenzdokumentation 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: Utility Library installieren

Codebeispiele durchsuchen

Ok

Clientbibliothek installieren

Java

Clientbibliothek installieren

Optional: Utility Library installieren

Codebeispiele durchsuchen

Node.js

Clientbibliothek installieren

Optional: Utility Library installieren

Codebeispiele durchsuchen

PHP

Clientbibliothek installieren

Optional: Utility Library installieren

Codebeispiele durchsuchen

Python

Clientbibliothek installieren

Optional: Utility Library installieren

Codebeispiele durchsuchen

Ruby

Clientbibliothek installieren

Nächste Schritte

Clientbibliothek installieren