API-Zugriff einrichten

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

Vorbereitung

  1. Ein Google Cloud-Projekt oder ein Google-Konto, das Inhaber des Projekts sein soll.

    • Wenn Sie kein Projekt haben, wird im nächsten Abschnitt ein Projekt 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 Service Usage-Administrator. Wenn Sie Ihre Rolle prüfen möchten, öffnen Sie in der Google Cloud Console die IAM-Seite, wählen Sie Ihr Projekt aus und suchen Sie Ihr Google-Konto in der Liste.

      Weitere Informationen finden Sie unter Aktuellen Zugriff ansehen.

  2. Die Google Cloud CLI ist installiert.

API aktivieren

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

Data Manager API aktivieren

Wenn Sie die Data Manager API nicht finden oder die Aktivierung der Data Manager API 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 die Informationen unter Die richtige Authentifizierungsmethode für Ihren Anwendungsfall auswählen anzusehen, 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, nicht Personen, als Nutzer dar. Damit können Ihre Anwendungen die Authentifizierung und Autorisierung verwalten. Beispiel: Eine App muss auf Google Cloud-Ressourcen zugreifen.

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

Wählen Sie Nutzerkonto oder Dienstkonto aus, um Standardanmeldedaten für Anwendungen 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 Zielgruppe auf und konfigurieren Sie die Einstellungen für die erste Entwicklung:

      • Setzen Sie den Veröffentlichungsstatus auf Test.
      • Legen Sie den Nutzertyp auf Intern fest, wenn sich Ihr Projekt in einer Google Workspace-Organisation befindet, oder auf Extern, wenn dies nicht der Fall ist.
      • Wenn Sie Extern verwenden, fügen Sie die Google-Konten, die Sie zum Generieren von Anmeldedaten verwenden, als Testnutzer hinzu.

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

  3. Klicken Sie auf OAuth2-Client erstellen, um einen OAuth2-Client im Projekt zu erstellen, oder folgen Sie der Anleitung, um einen OAuth2-Client vom Typ Desktop zu erstellen. Sie können diesen Schritt überspringen, wenn Sie bereits einen OAuth2-Client vom Typ Desktop haben, den Sie für die Data Manager API verwenden möchten.

    Wenn Sie auf OAuth2-Client erstellen klicken, wählen Sie Desktop-Anwendung 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 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 im 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 Liste --scopes 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"

  5. Prüfen Sie mit dem folgenden Befehl, ob die Anmeldedaten korrekt eingerichtet sind. Wenn der Vorgang erfolgreich ist, wird ein Zugriffstoken in der Konsole ausgegeben.

    gcloud auth application-default print-access-token

Dienstkonto

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

  1. Klicken Sie auf den folgenden Button 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 Berechtigung serviceusage.services.use 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 Ersteller von Dienstkonto-Tokens (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 Standardanmeldedaten für Anwendungen 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 Google Ads API-Bereich in die Liste --scopes 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 Liste --scopes 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"

    Wenn Sie zur Anmeldung aufgefordert werden, melden Sie sich mit Ihrem Google-Konto an, das die Rolle „Ersteller von Dienstkonto-Tokens“ hat.

  5. Prüfen Sie mit dem folgenden Befehl, ob die Anmeldedaten korrekt eingerichtet sind. Wenn der Vorgang erfolgreich ist, gibt der Befehl ein Zugriffstoken in der Konsole aus.

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

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

Kontozugriff einrichten

Nutzerkonto

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

  • Wählen Sie Werbetreibender aus, wenn Sie die 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 die Anmeldedaten für ein Google-Konto verwenden, das ein Nutzer in einem Datenpartnerkonto ist, und Sie Werbetreibendenkonten verwalten möchten, die eine Partnerverknüpfung mit dem Datenpartnerkonto haben. Datenpartnerkonten werden erst nach Abschluss des Genehmigungsverfahrens ausgestellt. Füllen Sie zuerst das Antragsformular aus.

Advertiser

Gewähren Sie der mit dem Nutzer verknüpften E-Mail-Adresse Zugriff auf 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 für den API-Zugriff in der Regel ein Dienstkonto. 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 die 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 die Anmeldedaten für ein Google-Konto verwenden, das ein Nutzer in einem Datenpartnerkonto ist, und Sie Werbetreibendenkonten verwalten möchten, die eine Partnerverknüpfung mit dem Datenpartnerkonto haben. Datenpartnerkonten werden erst nach Abschluss des Genehmigungsverfahrens ausgestellt. Füllen Sie zuerst das Antragsformular aus.

Advertiser

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

Schließen Sie die Einrichtung des Kontozugriffs ab, 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 Dienstkonto 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 das Datenpartnerkonto 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