Übersicht

Sie können Datensegmente mit der Authorized Buyers Marketplace API erstellen und verwalten. Diese API stellt eine curators.dataSegments-Ressource zur Verfügung. Dies ist eine REST API mit generierten Clientbibliotheken, die Sie für Ihre Integration verwenden können.

Authentifizierung einrichten

Google APIs verwenden zur Authentifizierung und Autorisierung das OAuth 2.0-Protokoll. So richten Sie ein Dienstkonto für den Zugriff auf die Marketplace API ein:

  1. Falls noch nicht geschehen, erstellen Sie ein Google Cloud-Projekt, in dem die Anmeldedaten für den API-Zugriff gespeichert werden.
  2. Rufen Sie die Seite Aktivierte APIs in der Google Cloud Console auf. Wählen Sie das Projekt aus, das Sie zuvor erstellt haben.

  3. Eine Liste der aktivierten APIs und Dienste wird angezeigt. Um auf die Marketplace API zuzugreifen, müssen Sie sie aktivieren. Wenn die Marketplace API nicht aktiviert ist, klicken Sie auf + APIs und Dienste aktivieren und folgen Sie der Anleitung:

    1. Sie werden auf eine Seite mit einem Suchfeld weitergeleitet. Suchen Sie nach Authorized Buyers Marketplace API.
    2. Wählen Sie auf der Ergebnisseite Authorized Buyers Marketplace API aus.
    3. Klicken Sie auf Aktivieren.
  4. Wählen Sie im Navigationsmenü die Option Credentials aus.
  5. Klicken Sie auf + Anmeldedaten erstellen und wählen Sie im Drop-down-Menü Dienstkonto aus.
  6. Geben Sie einen Namen für das Dienstkonto ein. Die Dienstkonto-ID wird automatisch bei der Erstellung generiert. Notieren Sie sich diesen Wert, da er später in Schritt 14 benötigt wird. Geben Sie optional eine Beschreibung ein. Klicken Sie auf Erstellen und fortfahren.
  7. Konfigurieren Sie optional Berechtigungen für das Dienstkonto und klicken Sie auf Weiter.
  8. Konfigurieren Sie optional Nutzer oder Gruppen, die Aktionen als Dienstkonto ausführen können, und klicken Sie auf Fertig.
  9. Ihr neues Dienstkonto wird unter Dienstkonten aufgeführt. Suchen Sie nach der Dienstkonto-ID, die Sie gerade erstellt haben, und klicken Sie darauf.
  10. Klicken Sie auf den Tab Schlüssel.
  11. Wählen Sie im Drop-down-Menü Schlüssel hinzufügen die Option Neuen Schlüssel erstellen aus.
  12. Wählen Sie als Schlüsseltyp JSON aus und klicken Sie auf Erstellen.
  13. Laden Sie den Schlüssel in Ihr Arbeitsverzeichnis herunter. Weitere Informationen zum sicheren Speichern Ihres Schlüssels finden Sie unter Dienstkontoschlüssel verwalten. Der Schlüssel wird von Ihrer Anwendung für API-Aufrufe verwendet.
  14. Geben Sie die Dienstkonto-ID an Ihren Technical Account Manager weiter, damit das Dienstkonto mit Ihrem Konto verknüpft werden kann.

API-Bereiche

Wenn Sie den OAuth 2.0-Ablauf durchlaufen, um ein Zugriffstoken für einen API-Aufruf zu erhalten, müssen Sie die APIs angeben, auf die mit diesem Token zugegriffen werden kann. Für die Authorized Buyers Marketplace API ist das der Bereich https://www.googleapis.com/auth/authorized-buyers-marketplace.

Datensegmente in der API im Vergleich zur Echtzeit-Kuratierung identifizieren

In der Marketplace API werden Datensegmente mit einem API-spezifischen Ressourcennamen identifiziert, z. B.:

"curators/[YOUR_ACCOUNT_ID]/dataSegments/[DATA_SEGMENT_ID]".

Wenn Sie die für eine Anzeigenmöglichkeit in der Echtzeit-Kuration relevanten Datensegmente identifizieren, geben Sie den Wert für die DATA_SEGMENT_ID-Ressourcen-ID anstelle der vollständigen Ressource name an, die von der API verwendet wird.

Nächste Schritte