Curation Partners API

Die Curation Partners API ist eine extern verfügbare HTTP API für Kuratoren, mit der sie ihre Datensegmente und kuratierten Pakete, die von Werbeagenturen verwendet werden, programmatisch verwalten können.

Dienst: curationpartners.googleapis.com

Wir empfehlen, diesen Dienst mit den von Google bereitgestellten Clientbibliotheken aufzurufen. Wenn Ihre Anwendung diesen Dienst mit Ihren eigenen Bibliotheken aufrufen muss, sollten Sie die folgenden Informationen verwenden, wenn Sie die API-Anfragen senden.

Discovery-Dokument

Ein Discovery-Dokument ist eine maschinenlesbare Spezifikation zum Beschreiben und Nutzen von REST APIs. Sie wird verwendet, um Clientbibliotheken, IDE-Plug-ins und andere Tools zu erstellen, die mit Google APIs interagieren. Ein Dienst kann mehrere Discovery-Dokumente haben. Dieser Dienst stellt folgendes Discovery-Dokument bereit:

Dienstendpunkt

Ein Dienstendpunkt ist eine Basis-URL, die die Netzwerkadresse eines API-Dienstes angibt. Ein Dienst kann mehrere Dienstendpunkte haben. Dieser Dienst hat den folgenden Dienstendpunkt und alle nachstehenden URIs beziehen sich auf ihn:

  • https://curationpartners.googleapis.com

REST-Ressource: v1.curators.curatedPackages

Methoden
activate POST /v1/{name=curators/*/curatedPackages/*}:activate
Aktiviert ein vorhandenes kuratiertes Paket.
create POST /v1/{parent=curators/*}/curatedPackages
Erstellt ein neues kuratiertes Paket.
deactivate POST /v1/{name=curators/*/curatedPackages/*}:deactivate
Deaktiviert ein vorhandenes kuratiertes Paket.
get GET /v1/{name=curators/*/curatedPackages/*}
Ruft ein kuratiertes Paket anhand seines Ressourcennamens ab.
list GET /v1/{parent=curators/*}/curatedPackages
Listet kuratierte Pakete auf, die dem angegebenen Kurator gehören.
patch PATCH /v1/{curatedPackage.name=curators/*/curatedPackages/*}
Aktualisiert ein vorhandenes kuratiertes Paket.

REST-Ressource: v1.curators.dataSegments

Methoden
activate POST /v1/{name=curators/*/dataSegments/*}:activate
Aktiviert ein Datensegment.
create POST /v1/{parent=curators/*}/dataSegments
Erstellt ein Datensegment, das dem aufgeführten Kurator gehört.
deactivate POST /v1/{name=curators/*/dataSegments/*}:deactivate
Deaktiviert ein Datensegment.
get GET /v1/{name=curators/*/dataSegments/*}
Ruft ein Datensegment anhand seines Namens ab.
list GET /v1/{parent=curators/*}/dataSegments
Listet die Datensegmente auf, die einem Kurator gehören.
patch PATCH /v1/{dataSegment.name=curators/*/dataSegments/*}
Aktualisiert ein Datensegment.

REST-Ressource: v1.curators.reports

Methoden
create POST /v1/{parent=curators/*}/reports
Erstellt ein Report-Objekt.
delete DELETE /v1/{name=curators/*/reports/*}
Löscht ein Report-Objekt.
get GET /v1/{name=curators/*/reports/*}
Ruft ein Report-Objekt ab.
list GET /v1/{parent=curators/*}/reports
Listet Report-Objekte auf.
patch PATCH /v1/{report.name=curators/*/reports/*}
Aktualisiert ein Report-Objekt.
run POST /v1/{name=curators/*/reports/*}:run
Startet die Ausführung eines vorhandenen Berichts asynchron.

REST-Ressource: v1.curators.reports.operations

Methoden
get GET /v1/{name=curators/*/reports/*/operations/*}
Ruft den letzten Status eines Vorgangs mit langer Ausführungszeit ab.

REST-Ressource: v1.curators.reports.results

Methoden
fetchRows GET /v1/{name=curators/*/reports/*/results/*}:fetchRows
Gibt die Ergebniszeilen aus einem abgeschlossenen Bericht zurück.

REST-Ressource: v1.mediaPlanners

Methoden
list GET /v1/mediaPlanners
Listet alle Media Planner-Konten auf, auf die der Aufrufer Zugriff hat.