Einrichtung der DV360 Exchange Reporting API und OAuth-Einrichtung

Die DV360 Exchange Reporting API bietet 3PE-Partnern (Third-Party Exchange) programmatischen Zugriff auf Leistungsberichte aus Display & Video 360.

Die DV360 Exchange Reporting API ist eine Google Cloud API, die auf einer Zulassungsliste basiert und OAuth verwendet. Der Zulassungsprozess wird vom DV360 Exchange Reporting API-Team durchgeführt.

Vorgehensweise

So führen Sie das Onboarding für die DV360 Exchange Reporting API durch:

  1. Registrieren Sie ein Google-Konto in der Google Cloud Console.

    Dieses Konto dient zum Verwalten von Zugriffstokens für Ihren Produktionsclient. Verwenden Sie daher nicht Ihr privates Gmail-Konto.

  2. Wenden Sie sich mit den Kontoinformationen an Google DV360, um das Konto auf die Zulassungsliste setzen zu lassen.

  3. Nachdem Sie benachrichtigt wurden, dass Sie auf der Zulassungsliste stehen, beantragen Sie eine OAuth-Überprüfung, um Ihrer App Zugriff auf den Bereich doubleclickbidmanager zu gewähren.

  4. Melden Sie sich in der Google Cloud Console an.

    Rufen Sie APIs und Dienste > Bibliothek > Privat auf. Die DV360 Exchange Reporting API sollte als eine der verfügbaren APIs aufgeführt sein. Aktivieren Sie die DV360 Exchange Reporting API.

  5. Rufen Sie Anmeldedaten > Anmeldedaten erstellen > Dienstkontoschlüssel auf. Folgen Sie der Anleitung zum Erstellen eines Dienstkontos.

Dienstkonto

Mit einem Dienstkonto kann Ihr Code Anmeldedaten für Anwendungen direkt an die 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.

So erstellen Sie Dienstkontoanmeldedaten mit der Google Cloud Console:

  1. Wählen Sie auf der Seite API Manager > Anmeldedaten die Option Anmeldedaten erstellen → Dienstkontoschlüssel aus.

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

    Geben Sie 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.

    Wir empfehlen, den Wert unter Schlüsseltyp auf JSON zu belassen. Klicken Sie auf Erstellen, um einen JSON-Schlüssel als .json-Textdatei zu generieren. Laden Sie die Datei herunter, wenn Sie dazu aufgefordert werden. Das Dialogfeld Dienstkonto erstellt wird angezeigt.

    Hier ist ein Beispiel für einen JSON-Schlü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"
}

  3. Bewahren Sie die JSON-Datei sicher auf, da sie Ihren privaten Schlüssel enthält. Diese Datei ist die einzige Kopie dieses Schlüssels. Die Anmeldedaten in dieser Datei sind erforderlich, wenn Ihr Code API-Aufrufe ausführt.

  4. Wenden Sie sich mit den von Ihnen erstellten Dienstkonto-Informationen an DV360, insbesondere mit der E-Mail-Adresse des Dienstkontos. Das ist Teil des Prozesses für die Zulassungsliste für den API-Zugriff.

Zugriffstoken

Nachdem Ihr Dienstkonto für Aufrufe der API autorisiert wurde, können Sie mit den Beispielen in den API-Leitfäden fortfahren. Wenn Sie ein Zugriffstoken manuell abrufen möchten, können Sie ein Tool wie oauth2l verwenden oder sich mit einer unserer Clientbibliotheken programmgesteuert authentifizieren.