API-Zugriff einrichten

Nutzerkonto

So authentifizieren Sie sich mit Anmeldedaten für Nutzerkonten:

1. Konfigurieren Sie die Einstellungen der Google Auth Platform 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 der Data Manager API-Bereich ein vertraulicher Bereich ist, 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. 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 die Zielgruppe auf und aktualisieren Sie den Veröffentlichungs status und den Nutzertyp. 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 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 Display & Video 360 API-Bereich 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 die Identitätsübernahme des Dienstkontos verwenden, um sich zu authentifizieren. Bei 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 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. Diese Rolle enthält die Berechtigung , mit der das Dienstkonto API-Anfragen für das Projekt senden kann.serviceusage.services.use

   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 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 Google Ads API-Bereich 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 Display & Video 360 API-Bereich 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 „Ersteller von Dienstkonto-Tokens“ 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"
   

Nutzerkonto

Gewähren Sie der mit dem Nutzer verknüpften E-Mail-Adresse Zugriff auf das 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.
• Wenn Sie über ein Datenpartnerkonto mit einer Partnerverknüpfung aus dem Werbetreibendenkonto auf das Destination zugreifen, folgen Sie der Anleitung um die E-Mail-Adresse des Nutzers dem Datenpartnerkonto hinzuzufügen.

Dienstkonto

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

• Wenn Sie ein Google Ads-Konto verwenden, richten Sie den Kontozugriff ein, um das Dienstkonto 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 einen Display & Video 360-Nutzer zu erstellen, der mit dem Dienst konto verknüpft ist.
• Wenn Sie eine Google Analytics-Property verwenden, folgen Sie der Anleitung um die E-Mail-Adresse des Nutzers dem Konto hinzuzufügen.
• Wenn Sie über ein Datenpartnerkonto mit einer Partnerverknüpfung aus dem Werbetreibendenkonto auf das Destination zugreifen, richten Sie den Kontozugriff im Datenpartnerkonto ein, um das Dienstkonto hinzuzufügen und die Zugriffsebene festzulegen.