Curation Partners API

Interfejs API partnerów wyboru to dostępny zewnętrznie interfejs API HTTP, który umożliwia selekcjonerom automatyczne zarządzanie segmentami danych i wyselekcjonowanymi pakietami używanymi przez agencje reklamowe.

Usługa: curationpartners.googleapis.com

Zalecamy wywołanie tej usługi przy użyciu dostarczonych przez Google bibliotek klienta. Jeśli aplikacja musi wywoływać tę usługę przy użyciu własnych bibliotek, podczas tworzenia żądań interfejsu API należy używać poniższych informacji.

Dokument opisujący

Dokument opisujący to specyfikacja w formacie czytelnym dla komputerów, opisująca interfejsy API REST i sposób ich używania. Służy do tworzenia bibliotek klienta, wtyczek IDE i innych narzędzi, które współdziałają z interfejsami API Google. Jedna usługa może udostępniać wiele dokumentów opisujących. Ta usługa dostarcza następujący dokument opisujący interfejs API:

Punkt końcowy usługi

Punkt końcowy usługi to podstawowy adres URL, który określa adres sieciowy usługi interfejsu API. Jedna usługa może mieć wiele punktów końcowych. Ta usługa ma następujący punkt końcowy i wszystkie poniższe identyfikatory URI odnoszą się do niego:

  • https://curationpartners.googleapis.com

Zasób REST: v1.curators.curatedPackages

Metody
activate POST /v1/{name=curators/*/curatedPackages/*}:activate
Aktywuje istniejący wyselekcjonowany pakiet.
create POST /v1/{parent=curators/*}/curatedPackages
Tworzy nowy pakiet wyselekcjonowanych zasobów.
deactivate POST /v1/{name=curators/*/curatedPackages/*}:deactivate
Dezaktywuje istniejący wyselekcjonowany pakiet.
get GET /v1/{name=curators/*/curatedPackages/*}
Pobiera wyselekcjonowany pakiet na podstawie nazwy zasobu.
list GET /v1/{parent=curators/*}/curatedPackages
Wyświetla listę wyselekcjonowanych pakietów należących do określonego kuratora.
patch PATCH /v1/{curatedPackage.name=curators/*/curatedPackages/*}
Aktualizuje istniejący wyselekcjonowany pakiet.

Zasób REST: v1.curators.dataSegments

Metody
activate POST /v1/{name=curators/*/dataSegments/*}:activate
Aktywuje segment danych.
create POST /v1/{parent=curators/*}/dataSegments
Tworzy segment danych należący do podmiotu dokonującego selekcji.
deactivate POST /v1/{name=curators/*/dataSegments/*}:deactivate
Dezaktywuje segment danych.
get GET /v1/{name=curators/*/dataSegments/*}
Pobiera segment danych o podanej nazwie.
list GET /v1/{parent=curators/*}/dataSegments
Wyświetl listę segmentów danych należących do podmiotu dokonującego selekcji.
patch PATCH /v1/{dataSegment.name=curators/*/dataSegments/*}
Aktualizuje segment danych.

Zasób REST: v1.curators.reports

Metody
create POST /v1/{parent=curators/*}/reports
Tworzy obiekt Report.
delete DELETE /v1/{name=curators/*/reports/*}
Usuwa obiekt Report.
get GET /v1/{name=curators/*/reports/*}
Pobiera obiekt Report.
list GET /v1/{parent=curators/*}/reports
Wyświetla listę obiektów Report.
patch PATCH /v1/{report.name=curators/*/reports/*}
Aktualizuje obiekt Report.
run POST /v1/{name=curators/*/reports/*}:run
Inicjuje asynchroniczne wykonywanie istniejącego raportu.

Zasób REST: v1.curators.reports.operations

Metody
get GET /v1/{name=curators/*/reports/*/operations/*}
Pobiera najnowszy stan długo trwającej operacji.

Zasób REST: v1.curators.reports.results

Metody
fetchRows GET /v1/{name=curators/*/reports/*/results/*}:fetchRows
Zwraca wiersze wyników z ukończonego raportu.

Zasób REST: v1.mediaPlanners

Metody
list GET /v1/mediaPlanners
Wyświetla listę wszystkich kont media planera, do których rozmówca ma dostęp.
search GET /v1/mediaPlanners:search
Wyszukuje konta planera mediów pasujące do podanego identyfikatora stanowiska na platformie DSP.