Übersicht

Sie können Datensegmente mit der Curation Partners APIerstellen und verwalten. Diese API stellt eine curators.dataSegments Ressource bereit. Es handelt sich um eine REST API mit generierten Client bibliotheken, 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 Dienst Konto für den Zugriff auf die Curation Partners API ein:

  1. Erstellen Sie ein Google Cloud Projekt , in dem Ihre Anmeldedaten für den Zugriff auf die API gespeichert werden, falls noch nicht geschehen.

  2. Rufen Sie die Seite Aktivierte APIs in der Google Cloud Console auf. Wählen Sie das zuvor erstellte Projekt aus.

  3. Prüfen Sie die Liste der aktivierten APIs und Dienste. Um auf die Curation Partners API zuzugreifen, müssen Sie sie aktivieren. Wenn die Curation Partners API nicht aktiviert ist, klicken Sie auf + APIs und Dienste aktivieren und folgen Sie der Anleitung:

    1. Suchen Sie im Suchfeld nach Curation Partners API.
    2. Wählen Sie auf der Ergebnisseite Curation Partners API aus.
    3. Klicken Sie auf Aktivieren.

    Es ist ein bekanntes Problem, dass die Curation Partners API möglicherweise nicht über das Suchfeld der Google Cloud Console gefunden werden kann. Alternativ können Sie die API mit der Google Cloud CLI aktivieren. Nach der Installation der gcloud CLI können Sie die Curation Partners API mit dem folgenden Befehl aktivieren:

    gcloud services enable curationpartners.googleapis.com --project=CLOUD_PROJECT_ID

  4. Wählen Sie im Navigationsmenü Anmeldedaten 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 bei der Erstellung automatisch 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 die gerade erstellte Dienstkonto-ID 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 die Option 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 verwendet, um API-Aufrufe auszuführen.

  14. Teilen Sie Ihrem Technical Account Manager die Dienstkonto-ID mit, um das Dienstkonto mit Ihrem Konto zu verknüpfen.

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 Curation Partners API ist dieser Bereich https://www.googleapis.com/auth/curation-partners.

Datensegmente in der API und in der Echtzeit-Kuratierung identifizieren

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

"curators/ACCOUNT_ID/dataSegments/DATA_SEGMENT_ID".

Wenn Sie die für eine Werbegelegenheit relevanten Datensegmente in der Echtzeit-Kuratierungidentifizieren, geben Sie den Wert für die Ressourcen-ID DATA_SEGMENT_ID an und nicht den vollständigen Ressourcennamen, der von der API im Feld name bereitgestellt wird.

Nächste Schritte