API-Zugriff einrichten

So richten Sie den Zugriff auf die Data Manager API mit einem SDK oder REST ein:

Wählen Sie den gewünschten Einrichtungsprozess aus:

Vorbereitung

Bevor Sie die Data API verwenden können, benötigen Sie Folgendes:

Ein Google Cloud-Projekt.
Ein Google-Konto mit der Berechtigung serviceusage.services.enable für Ihr Google Cloud-Projekt oder mit einer Rolle, die diese Berechtigung enthält. Beispielsweise enthalten sowohl roles/owner als auch roles/serviceusage.serviceUsageAdmin die Berechtigung serviceusage.services.enable. Informationen zum Prüfen Ihrer Berechtigungen finden Sie unter Aktuellen Zugriff ansehen.
Die Google Cloud-Befehlszeile ist installiert.

API aktivieren

Wenn Sie die Data Manager API noch nicht aktiviert haben, klicken Sie auf Data Manager API aktivieren oder folgen Sie der Anleitung, um diesen Schritt manuell auszuführen.

Wenn Sie die Data Manager API nicht finden oder Data Manager API aktivieren fehlschlägt, prüfen Sie, ob Ihr Google-Konto die Voraussetzungen erfüllt.

Authentifizierung einrichten

Sie können alle Authentifizierungsmethoden bei Google außer API-Schlüsseln verwenden. Wir empfehlen, sich anzusehen, wie Sie die richtige Authentifizierungsmethode für Ihren Anwendungsfall auswählen, um zu entscheiden, welcher Ansatz für Ihren Anwendungsfall geeignet ist.

Zwei gängige Authentifizierungsmethoden sind Nutzerkonten und Dienstkonten:

Nutzerkonten: Stellen Personen dar, die direkt mit Google APIs und Diensten interagieren.
Dienstkonten: Stellen Apps als Nutzer dar, nicht Personen. Damit können Ihre Apps die Authentifizierung und Autorisierung verwalten. Das ist beispielsweise der Fall, wenn eine App auf Google Cloud-Ressourcen zugreifen muss.

Ihre Integration kann Standardanmeldedaten für Anwendungen (Application Default Credentials, ADC) verwenden, um Anmeldedaten automatisch aus der Umgebung zu finden. Sie müssen den Clientcode also nicht ändern, um sich zu authentifizieren.

Wählen Sie Nutzerkonto oder Identitätsübernahme des Dienstkontos aus, um ADC einzurichten:

So authentifizieren Sie sich mit Anmeldedaten für Nutzerkonten:

Konfigurieren Sie die Einstellungen für die Google Auth Platform für Ihr Projekt.

Wichtig :Für jede Google Cloud-App, mit der Nutzeranmeldedaten für den Data Manager API-Bereich abgerufen werden, muss die Google OAuth-Überprüfung durchgeführt werden, um zu vermeiden, dass Nutzer einen nicht bestätigten UI-Bildschirm sehen. Die Google OAuth-Überprüfung ist für Dienstkonten nicht erforderlich.
1. Öffnen Sie in der Google Cloud Console die Branding-Seite.
2. Wählen Sie Ihr Projekt aus.
3. Füllen Sie das Formular aus und klicken Sie auf Erstellen.
Da der Data Manager API-Bereich ein vertraulicher Bereich ist, sind die folgenden Schritte erforderlich:
1. Rufen Sie die Einstellungen für Data Access (Datenzugriff) für Ihr Projekt auf.
2. Klicken Sie auf Bereiche hinzufügen oder entfernen.
3. Klicken Sie in der Liste der Bereiche das Kästchen neben Data Manager API an und klicken Sie auf Aktualisieren.
4. Klicken Sie auf Speichern.
5. Rufen Sie in der Google Cloud Console Zielgruppe auf und aktualisieren Sie Veröffentlichungsstatus und Nutzertyp. Weitere Informationen zu diesen Einstellungen
Klicken Sie auf OAuth2-Client erstellen, um einen OAuth2-Client im Projekt zu erstellen, oder folgen Sie der Anleitung, um einen Desktop-OAuth2-Client zu erstellen. Sie können diesen Schritt überspringen, wenn Sie bereits einen Desktop-OAuth2-Client haben, den Sie für die Data Manager API verwenden möchten.

Wenn Sie auf OAuth2-Client erstellen klicken, wählen Sie Desktop-App aus, wenn Sie aufgefordert werden, Ihren OAuth-Client zu konfigurieren, damit Sie den Client in den verbleibenden Schritten verwenden können.

OAuth2-Client erstellen
Klicken Sie im letzten Schritt auf CLIENTKONFIGURATION HERUNTERLADEN und notieren Sie sich den von Ihnen ausgewählten Speicherort.

Generieren Sie eine lokale ADC-Datei, indem Sie den folgenden Befehl ausführen. Mit diesem Befehl wird ein Webvorgang gestartet, in dem Sie aufgefordert werden, sich in dem Google-Konto anzumelden, das Sie mit der API verwenden.

Ersetzen Sie PATH_TO_CLIENT_JSON durch den Namen der heruntergeladenen JSON-Datei.

gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"

Wenn Sie dieselben Anmeldedaten für die Data Manager API und die Google Ads API verwenden möchten, fügen Sie den Google Ads API-Bereich in die --scopes-Liste ein:

gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"

Wenn Sie dieselben Anmeldedaten für die Data Manager API und die Display & Video 360 API verwenden möchten, fügen Sie den Bereich der Display & Video 360 API in die Liste --scopes ein:

gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/display-video,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"

Prüfen Sie mit dem folgenden Befehl, ob die Anmeldedaten richtig eingerichtet sind. Wenn der Vorgang erfolgreich ist, wird in der Konsole ein Zugriffstoken ausgegeben.
```
gcloud auth application-default print-access-token
```

Weitere Informationen zur Authentifizierung und zu Anmeldedaten für Ihre App finden Sie unter Authentifizierungsmethoden bei Google und Funktionsweise von Standardanmeldedaten für Anwendungen.

Kontozugriff einrichten

Gewähren Sie der E‑Mail-Adresse, die mit Ihrem Nutzerkonto verknüpft ist, Zugriff auf Destination.

Wenn Sie ein Google Ads-Konto verwenden, folgen Sie der Anleitung, um die E-Mail-Adresse des Nutzers dem Google Ads-Konto oder einem übergeordneten Google Ads-Verwaltungskonto hinzuzufügen.
Wenn Sie ein Display & Video 360-Konto verwenden, folgen Sie der Anleitung, um die E-Mail-Adresse des Nutzers dem Konto hinzuzufügen.
Wenn Sie eine Google Analytics-Property verwenden, folgen Sie der Anleitung, um die E-Mail-Adresse des Nutzers dem Konto hinzuzufügen.

Nächste Schritte

Installieren Sie eine Clientbibliothek und führen Sie Codebeispiele aus, um Ihre erste Data Manager API-Anfrage zu testen.

Weiter

Clientbibliothek installieren