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 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.
Sehen Sie sich die Codebeispiele im Unterverzeichnis samples oder auf GitHub an.

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 im Installationsleitfaden für die Node.js-Clientbibliothek, um Ihrem Projekt eine Abhängigkeit von der Clientbibliothek @google-ads/datamanager 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 Dienstprogrammbibliothek:
```
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 Utility-Bibliothek 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 zur Installation der 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

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-Bibliothek und Codebeispiele abrufen

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