API-Zugriff einrichten

Hier erfahren Sie, wie Sie den Zugriff auf die Data Manager API mit einem SDK oder REST einrichten.

Vorbereitung

  1. Ein Google Cloud-Projekt oder ein Google Konto, mit dem Sie Inhaber des Projekts sein möchten.

    • Wenn Sie kein Projekt haben, wird im Einrichtungsprozess im nächsten Abschnitt eines für Sie erstellt.

    • Wenn Sie bereits ein Projekt haben, muss Ihr Google-Konto eine Rolle haben, mit der APIs im Projekt aktiviert werden können, z. B. Inhaber, Bearbeiter, oder Administrator der Dienstnutzung. Rufen Sie die IAM Seite in der Google Cloud Console auf, wählen Sie Ihr Projekt aus und suchen Sie in der Liste nach Ihrem Google-Konto, um Ihre Rolle zu prüfen.

      Weitere Informationen finden Sie unter Aktuellen Zugriff ansehen.

  2. Die installierte Google Cloud CLI installiert.

API aktivieren

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

Data Manager API aktivieren

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 neben API-Schlüsseln auch alle anderen Authentifizierungsmethoden von Google verwenden. Wir empfehlen Ihnen, sich anzusehen, wie Sie die richtige Authentifizierungsmethode für Ihren Anwendungs fall 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 Anwendungen und nicht Personen als Nutzer dar. Mit ihnen können Ihre Anwendungen die Authentifizierung und Autorisierung verwalten. Das ist beispielsweise erforderlich, wenn eine Anwendung 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, sodass Sie den Clientcode nicht ändern müssen, um sich zu authentifizieren.

Wählen Sie Nutzerkonto oder Dienstkonto aus, um ADC einzurichten:

Nutzerkonto

So authentifizieren Sie sich mit Nutzerkonto Anmeldedaten:

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

    1. Öffnen Sie in der Google Cloud Console die Seite Branding.

    2. Wählen Sie Ihr Projekt aus.

    3. Füllen Sie das Formular aus und klicken Sie auf Erstellen.

  2. Da die Data Manager API sensible Bereiche verwendet, sind die folgenden Schritte erforderlich:

    1. Rufen Sie die Einstellungen für den Datenzugriff für Ihr Projekt auf.

    2. Klicken Sie auf Bereiche hinzufügen oder entfernen.

    3. Suchen Sie in der Liste der Bereiche nach Data Manager API und setzen Sie ein Häkchen für jeden Bereich, den Ihre Anwendung benötigt:

      • .../auth/datamanager: Wählen Sie diesen Bereich für Standard-API-Vorgänge aus, z. B. zum Verwalten von Kundendaten, Zielgruppen und Ereignissen. Dies ist der primäre Bereich, der in diesem Leitfaden verwendet wird.

      • .../auth/datamanager.partnerlink: Wählen Sie diesen Bereich nur aus, wenn Sie ein Datenpartner sind, der Partnerlinks in Werbetreibendenkonten erstellt oder löscht.

    4. Klicken Sie auf Aktualisieren.

    5. Klicken Sie auf Speichern.

    6. Rufen Sie in der Google Cloud Console die Zielgruppe auf und konfigurieren Sie die Einstellungen für die erste Entwicklung:

      • Setzen Sie Veröffentlichungsstatus auf Testen.
      • Setzen Sie Nutzertyp auf Intern (wenn sich Ihr Projekt in einer Google Workspace-Organisation befindet) oder Extern (wenn nicht).
      • Wenn Sie Extern verwenden, fügen Sie die Google-Konten, mit denen Sie Anmeldedaten generieren, als Testnutzer hinzu.

      Weitere Informationen zu diesen Einstellungen finden Sie unter Zielgruppe der App verwalten.

  3. 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 bei der Aufforderung OAuth-Client konfigurieren die Option Desktop-App aus, 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 ausgewählten Downloadspeicherort.

  4. Generieren Sie mit dem folgenden Befehl eine lokale ADC-Datei. Mit diesem Befehl wird ein Webablauf 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 Bereich der Google Ads API 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 --scopes Liste 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"

  5. Bestätigen Sie mit dem folgenden Befehl, dass die Anmeldedaten korrekt eingerichtet sind. Wenn der Vorgang erfolgreich ist, wird mit dem Befehl ein Zugriffstoken in der Konsole ausgegeben.

    gcloud auth application-default print-access-token

Dienstkonto

Hier erfahren Sie, wie Sie ein Dienstkonto erstellen und die Dienstkonto Identitätsübernahme verwenden, um sich in einer lokalen Entwicklungsumgebung zu authentifizieren. Bei diesen Schritten wird die Identitätsübernahme anstelle von Dienst kontoschlüsseln verwendet, da Dienstkontoschlüssel zu einem Sicherheitsrisiko werden können, wenn sie nicht sorgfältig verwaltet werden.

  1. Klicken Sie auf die folgende Schaltfläche Dienstkonto erstellen oder folgen Sie der Anleitung um ein Dienstkonto auszuwählen oder zu erstellen.

    Dienstkonto erstellen

  2. Weisen Sie dem Dienstkonto die IAM-Rolle „Service Usage Consumer“ (roles/serviceusage.serviceUsageConsumer) zu, die die serviceusage.services.use Berechtigung enthält, mit der das Dienstkonto API-Anfragen für das Projekt senden kann.

    gcloud projects add-iam-policy-binding PROJECT_ID \
  --member="serviceAccount:SERVICE_ACCOUNT_EMAIL" \
  --role="roles/serviceusage.serviceUsageConsumer"

  3. Weisen Sie Ihrem Google-Konto die IAM-Rolle „Service Account Token Creator“ (roles/iam.serviceAccountTokenCreator) für das Dienstkonto zu.

    gcloud iam service-accounts add-iam-policy-binding SERVICE_ACCOUNT_EMAIL \
  --member="user:USER_EMAIL" \
  --role="roles/iam.serviceAccountTokenCreator"

  4. Konfigurieren Sie Ihre ADC-Datei mit dem folgenden Befehl:

    gcloud auth application-default login \
  --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/cloud-platform"

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

    gcloud auth application-default login \
  --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform"

    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 --scopes Liste ein:

    gcloud auth application-default login \
  --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/display-video,https://www.googleapis.com/auth/cloud-platform"

    Melden Sie sich bei der Aufforderung zur Anmeldung mit Ihrem Google-Konto an, das die Rolle „Service Account Token Creator“ hat.

  5. Bestätigen Sie mit dem folgenden Befehl, dass die Anmeldedaten korrekt eingerichtet sind. Wenn der Vorgang erfolgreich ist, wird mit dem Befehl ein Zugriffstoken in der Konsole ausgegeben.

    gcloud auth application-default print-access-token --scopes="https://www.googleapis.com/auth/datamanager"

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

Zugriff auf das Konto einrichten

Nutzerkonto

Wählen Sie den Tab aus, der Ihrem Anwendungsfall entspricht.

  • Wählen Sie Werbetreibender aus, wenn Sie Anmeldedaten für ein Google-Konto verwenden, das ein Nutzer in den Werbetreibendenkonten ist, die Sie verwalten möchten.
  • Wählen Sie Datenpartner aus, wenn Sie Anmeldedaten für ein Google Konto verwenden, das ein Nutzer in einem Datenpartnerkonto ist, und Sie Werbetreibendenkonten verwalten möchten, die einen Partner link zum Datenpartnerkonto haben. Datenpartnerkonten werden erst nach Abschluss des Genehmigungsprozesses ausgestellt. Füllen Sie dazu das Antragsformular aus.

Werbetreibender

Gewähren Sie der mit dem Nutzer verknüpften E-Mail-Adresse Zugriff auf das Destination.

Folgen Sie der Anleitung um die E-Mail-Adresse des Nutzers dem Google Ads-Konto oder einem übergeordneten Google Ads-Verwaltungskonto hinzuzufügen.

Display &Video 360

Folgen Sie der Anleitung um die E-Mail-Adresse des Nutzers dem Konto hinzuzufügen.

Google Analytics

Folgen Sie der Anleitung um die E-Mail-Adresse des Nutzers dem Konto hinzuzufügen.

Datenpartner

Gewähren Sie der mit dem Nutzer verknüpften E-Mail-Adresse Zugriff auf Ihr Datenpartnerkonto. Datenpartner verwenden in der Regel ein Dienstkonto für den API-Zugriff. Wenn Sie jedoch ein Nutzerkonto für Tests oder andere Zwecke verwenden, müssen Sie Ihrem Nutzerkonto Zugriff auf das Datenpartnerkonto gewähren.

Fügen Sie die E-Mail-Adresse des Nutzers über die Google Ads-Benutzeroberfläche dem Datenpartnerkonto hinzu. Folgen Sie dazu dieser Anleitung.

Dienstkonto

Wählen Sie den Tab aus, der Ihrem Anwendungsfall entspricht.

  • Wählen Sie Werbetreibender aus, wenn Sie Anmeldedaten für ein Google-Konto verwenden, das ein Nutzer in den Werbetreibendenkonten ist, die Sie verwalten möchten.
  • Wählen Sie Datenpartner aus, wenn Sie Anmeldedaten für ein Google Konto verwenden, das ein Nutzer in einem Datenpartnerkonto ist, und Sie Werbetreibendenkonten verwalten möchten, die einen Partner link zum Datenpartnerkonto haben. Datenpartnerkonten werden erst nach Abschluss des Genehmigungsprozesses ausgestellt. Füllen Sie dazu das Antragsformular aus.

Werbetreibender

Gewähren Sie der mit Ihrem Dienstkonto verknüpften E-Mail-Adresse Zugriff auf das Destination.

Führen Sie die Einrichtung des Kontozugriffs aus, um das Dienstkonto dem Google Ads-Konto oder einem übergeordneten Google Ads-Verwaltungskonto hinzuzufügen.

Display &Video 360

Folgen Sie der Anleitung um einen Display & Video 360-Nutzer zu erstellen, der mit dem Dienst konto verknüpft ist.

Google Analytics

Folgen Sie der Anleitung um die E-Mail-Adresse des Dienstkontos dem Konto hinzuzufügen.

Datenpartner

Gewähren Sie der mit Ihrem Dienstkonto verknüpften E-Mail-Adresse Zugriff auf Ihr Datenpartnerkonto.

Der Zugriff auf Datenpartnerkonten wird über die Google Ads-Benutzeroberfläche verwaltet. Folgen Sie der Anleitung unter Kontozugriff einrichten, um das Dienstkonto hinzuzufügen und die Zugriffsebene festzulegen.

Nächste Schritte

Weiter
Clientbibliothek installieren