Auth einrichten

Onboarding für die Display &Video 360 Seller API

Für das Onboarding mit der Display &Video 360 Seller API sind einige wichtige Schritte erforderlich. Die DV360 Seller API ist eine Google Cloud API, die auf einer Zulassungsliste basiert und OAuth 2.0 zur Authentifizierung und Autorisierung verwendet.

Der Prozess für die Zulassungsliste wird vom Team der Display &Video 360 Seller API verwaltet.

Onboarding-Schritte:

  1. Registrieren Sie sich für ein Google-Konto unter https://console.cloud.google.com/.
    • Mit diesem Konto werden Zugriffstokens für Ihren Produktionsclient verwaltet. Verwenden Sie kein privates Gmail-Konto.
    • Das Konto darf keine Google-Gruppe sein.
    • Wenn Sie ein vorhandenes Google Cloud-Projekt verwenden:Das Konto muss ein Administrator des Projekts sein.
  2. Teilen Sie dem Google DV360-Team Ihre Kontodetails mit, damit es Ihr Konto der Zulassungsliste hinzufügen kann.
  3. Warten Sie auf die Bestätigung, dass Ihr Konto aktiviert wurde.
  4. Optional und nicht blockierend: Senden Sie eine Anfrage zur OAuth-Überprüfung für Ihre Anwendung, um auf den Bereich https://www.googleapis.com/auth/doubleclickbidmanager zuzugreifen.
  5. Rufen Sie in der Google Cloud Console APIs und Dienste > Bibliothek > Privat auf. Die DV360 Seller API sollte für Ihr Projekt verfügbar sein.
  6. Aktivieren Sie die DV360 Seller API.
  7. Rufen Sie APIs und Dienste > Anmeldedaten > Anmeldedaten erstellen > Dienstkontoschlüssel auf. Folgen Sie der Einrichtungsanleitung in der Dokumentation zu OAuth 2.0-Dienstkonten.

    Dienstkonto einrichten:

    Hinweis: Teilen Sie uns mit, wenn Sie ein vorhandenes Dienstkonto wiederverwenden möchten, z. B. eines, das für die DV360 Reporting API verwendet wird.

    Die Google Cloud API-Authentifizierung und -Autorisierung (normalerweise als „auth“ gruppiert) erfolgt in der Regel über ein Dienstkonto. Mit einem Dienstkonto kann Ihr Code Anmeldedaten für Anwendungen direkt an die Cloud API senden. Ein Dienstkonto wird, wie ein Nutzerkonto, durch eine E-Mail-Adresse dargestellt. Im Gegensatz zu einem Nutzerkonto gehört ein Dienstkonto jedoch nur zu einer Anwendung und kann nur für den Zugriff auf die API verwendet werden, für die es erstellt wurde. Als Beispiel zeigen wir, wie Sie Anmeldedaten für ein Dienstkonto mit der Google Cloud Platform Console erstellen.

    Google Cloud Console verwenden

    Wählen Sie auf der Seite Google Cloud Console API Manager → Anmeldedaten „Anmeldedaten erstellen → Dienstkontoschlüssel“ aus.

    alt_text

    Wählen Sie dann im Drop-down-Menü „Dienstkonto“ die Option „Neues Dienstkonto“ aus.

    alt_text

    Geben Sie unter „Name“ einen Namen für dieses Dienstkonto ein. Dieser Name wird als Standardname für Ihre Dienstkonto-ID (links von „@“ in der generierten Dienstkonto-ID-Adresse) verwendet. Sie können diese Dienstkonto-ID jedoch ändern. Diese Namen können willkürlich gewählt werden. Es kommt nur darauf an, sich diese Namen zu merken. Wir empfehlen, unter „Schlüsseltyp“ die Einstellung „JSON“ zu belassen. Klicken Sie auf „Erstellen“. Die GCP Console erstellt daraufhin einen JSON-Schlüssel (als .json-Textdatei), fordert Sie zum Herunterladen der Datei auf Ihren Computer auf und zeigt das Dialogfeld Dienstkonto erstellt an.

    alt_text

    Der generierte JSON-Schlüssel sollte ähnlich aussehen wie der folgende JSON-Beispielschlüssel: 

    {
  "type": "service_account",
  "project_id": "project-id",
  "private_key_id": "some_number",
  "private_key": "-----BEGIN PRIVATE KEY-----\n....
  =\n-----END PRIVATE KEY-----\n",
  "client_email": "<api-name>api@project-id.iam.gserviceaccount.com",
  "client_id": "...",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://accounts.google.com/o/oauth2/token",
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
  "client_x509_cert_url": "https://www.googleapis.com/...<api-name>api%40project-id.iam.gserviceaccount.com"
}

    Bewahren Sie die JSON-Datei sicher auf, da sie Ihren privaten Schlüssel enthält (und diese Datei ist die einzige Kopie dieses Schlüssels). Sie müssen in Ihrem Code auf diese Dienstkonto-Schlüsseldatei verweisen, wenn Sie Anmeldedaten an die Google Cloud Platform API senden möchten.

  8. Teilen Sie dem DV360-Team die Informationen zum Dienstkonto mit, das Sie erstellt haben (insbesondere die E-Mail-Adresse des Dienstkontos). Dies ist ein zweiter Schritt für die Zulassungsliste zur Autorisierung.
  9. Sobald Ihr Dienstkonto zum Aufrufen der API autorisiert ist, können Sie die Dokumentation zur DV360 Seller API aufrufen. Eine Anleitung zum manuellen Abrufen eines Autorisierungstokens finden Sie im Repository des Tools oauth2l (mit dem heruntergeladenen JSON-Dienstkontoschlüssel). Eine detaillierte Anleitung zum programmatischen Abrufen von OAuth-Tokens finden Sie in der Dokumentation zur Google Cloud-Authentifizierung.

Wichtig: Der OAuth-Bereich muss https://www.googleapis.com/auth/doubleclickbidmanager sein.

Zurück
Überblick
Weiter
Clientbibliothek