Ads Data Hub API

Interfejs API do wykonywania zapytań dotyczących Centrum danych reklam.

Usługa: adsdatahub.googleapis.com

Aby zadzwonić do tej usługi, zalecamy użycie bibliotek klienckich udostępnionych przez Google. Jeśli Twoja aplikacja musi użyć własnych bibliotek, aby wywołać tę usługę, użyj tych informacji podczas wysyłania żądań do interfejsu API.

Dokument Discovery

Dokument Discovery to zrozumiała dla komputera specyfikacja dotycząca interfejsów API REST i korzystania z nich. Służy do tworzenia bibliotek klientów, wtyczek IDE i innych narzędzi, które współpracują z interfejsami API Google. Jedna usługa może udostępniać wiele dokumentów Discovery. 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 określający adres sieci usługi interfejsu API. Jedna usługa może mieć wiele punktów końcowych usługi. Ta usługa ma następujący punkt końcowy usługi, a wszystkie poniższe identyfikatory URI są zależne od tego punktu końcowego:

  • https://adsdatahub.googleapis.com

Zasób REST: v1.customers

Metody
describeValidDv360AdvertiserIds POST /v1/{customer=customers/*}:describeValidDv360AdvertiserIds
Opisuje prawidłowe identyfikatory reklamodawców DV360
describeValidFrequencyLimitingEventMatchers GET /v1/{customer=customers/*}:describeValidFrequencyLimitingEventMatchers
Lista prawidłowych dopasowań zdarzeń wraz z ich metadanymi dotyczącymi list odbiorców z ograniczeniem liczby wyświetleń.
exportJobHistory POST /v1/{customer=customers/*}:exportJobHistory
Eksportuje historię zadań konta klienta do wybranego przez klienta zbioru danych BigQuery.
generateDv360IvtVideoViewabilityReport POST /v1/{customer=customers/*}:generateDv360IvtVideoViewabilityReport
Rozpoczyna wykonywanie zapytania w celu pobrania z platformy DV360 danych o nieprawidłowym ruchu.
generateIvtReport POST /v1/{name=customers/*}:generateIvtReport
Rozpoczyna wykonywanie zapytania w celu pobrania z każdego dnia podsumowania nieprawidłowego ruchu dla konkretnej platformy.
get GET /v1/{name=customers/*}
Pobiera wybranego klienta Centrum danych reklam.
getImportCompletionStatus GET /v1/{customer=customers/*}/importCompletionStatus
Zwraca odsetek danych Google wszystkich klientów, którzy pozyskali CDR w danym dniu.
list GET /v1/customers
Zawiera listę klientów Centrum danych reklam, do których ma dostęp bieżący użytkownik.

Zasób REST: v1.customers.adsDataCustomers

Metody
get GET /v1/{name=customers/*/adsDataCustomers/*}
Pobiera wybranego klienta Centrum danych reklam.
getDataAccessBudget GET /v1/{name=customers/*/adsDataCustomers/*/dataAccessBudget}
Pobiera budżet dostępu do danych żądanych źródeł danych reklam z ostatnich 366 dni.
list GET /v1/{parent=customers/*}/adsDataCustomers
Wyświetla listę danych reklam dostępnych dla klienta.

Zasób REST: v1.customers.analysisQuery

Metody
create POST /v1/{parent=customers/*}/analysisQueries
Tworzy zapytanie analityczne na potrzeby późniejszego wykonania.
delete DELETE /v1/{name=customers/*/analysisQueries/*}
Usuwa zapytanie analityczne.
get GET /v1/{name=customers/*/analysisQueries/*}
Pobiera żądane zapytanie analityczne.
list GET /v1/{parent=customers/*}/analysisQueries
Wyświetla listę zapytań analitycznych należących do określonego klienta.
patch PATCH /v1/{query.name=customers/*/analysisQueries/*}
Aktualizuje istniejące zapytanie analityczne.
start POST /v1/{name=customers/*/analysisQueries/*}:start
Rozpoczyna wykonanie zapisanego zapytania analitycznego.
startTransient POST /v1/{parent=customers/*}/analysisQueries:startTransient
Rozpoczyna wykonywanie działania na przejściowym zapytaniu analizy.
validate POST /v1/{parent=customers/*}/analysisQueries:validate
Przeprowadza statyczne walidacje dla podanego zapytania analitycznego.

Zasób REST: v1.customers.customBiddingAlgorithms

Metody
addAdvertiser POST /v1/{customBiddingAlgorithm=customers/*/customBiddingAlgorithms/*}:addAdvertiser
Dodaj reklamodawcę z DV360 do algorytmu ustalania stawek niestandardowych.
create POST /v1/{parent=customers/*}/customBiddingAlgorithms
Utworzy algorytm ustalania stawek zarządzany przez Centrum danych reklam.
delete DELETE /v1/{name=customers/*/customBiddingAlgorithms/*}
Usuń ten algorytm ustalania stawek niestandardowych.
execute POST /v1/{name=customers/*/customBiddingAlgorithms/*}:execute
Oceny wyświetleń z ostatnich 30 dni dla modeli ustalania stawek niestandardowych.
get GET /v1/{name=customers/*/customBiddingAlgorithms/*}
Pobiera żądany algorytm ustalania stawek zarządzany przez Centrum danych reklam.
list GET /v1/{parent=customers/*}/customBiddingAlgorithms
Lista algorytmów ustalania stawek niestandardowych zarządzanych przez określonego klienta Centrum danych reklam.
patch PATCH /v1/{customBiddingAlgorithm.name=customers/*/customBiddingAlgorithms/*}
Aktualizuje żądany algorytm ustalania stawek zarządzany przez Centrum danych reklam.
removeAdvertiser POST /v1/{customBiddingAlgorithm=customers/*/customBiddingAlgorithms/*}:removeAdvertiser
Usuń reklamodawcę DV360 z algorytmu określania stawek niestandardowych.

Zasób REST: v1.customers.tables

Metody
get GET /v1/{name=customers/*/tables/*}
Pobiera tabelę Centrum danych reklam.
list GET /v1/{parent=customers/*}/tables
Wyświetlanie tabel Centrum danych reklam, do których ma dostęp określony klient.

Zasób REST: v1.customers.tempTables

Metody
get GET /v1/{name=customers/*/tempTables/*}
Pobiera żądaną tabelę tymczasową Centrum danych reklam.
list GET /v1/{parent=customers/*}/tempTables
Zawiera listę tabel tymczasowych Centrum danych reklam utworzonych przez klienta.

Zasób REST: v1.customers.userListQuery

Metody
create POST /v1/{parent=customers/*}/userListQueries
Utworzy zapytanie dotyczące listy użytkowników na potrzeby późniejszego wykonania.
delete DELETE /v1/{name=customers/*/userListQueries/*}
Usuwa zapytanie dotyczące listy użytkowników.
get GET /v1/{name=customers/*/userListQueries/*}
Pobiera zapytanie listy użytkowników.
list GET /v1/{parent=customers/*}/userListQueries
Lista zapytań, które należą do określonego klienta na liście użytkowników.
patch PATCH /v1/{query.name=customers/*/userListQueries/*}
Aktualizuje istniejące zapytanie o listę użytkowników.
start POST /v1/{name=customers/*/userListQueries/*}:start
Rozpoczyna wykonywanie zapytania na zapisanej liście użytkowników.
startTransient
(deprecated)		 POST /v1/{parent=customers/*}/userListQueries:startTransient
Rozpoczyna wykonywanie zapytania na przejściowym liście użytkowników.
validate POST /v1/{parent=customers/*}/userListQueries:validate
Przeprowadza statyczne walidacje dla podanego zapytania użytkownika o listę.

Zasób REST: v1.customers.userLists

Metody
addEventMatchers POST /v1/{userList=customers/*/userLists/*}:addEventMatchers
Dodaje dopasowania do zdarzeń do listy użytkowników na podstawie częstotliwości.
addRecipients POST /v1/{userList=customers/*/userLists/*}:addRecipients
Dodaj elementy do odbiorców na liście użytkowników zarządzanych przez Centrum danych reklam.
create POST /v1/{parent=customers/*}/userLists
Utworzy listę użytkowników zarządzaną przez Centrum danych reklam.
delete DELETE /v1/{name=customers/*/userLists/*}
Usuń wybraną listę użytkowników zarządzaną przez Centrum danych reklam.
generateFrequencyListMemberships POST /v1/{name=customers/*/userLists/*}:generateFrequencyListMemberships
Generowanie członkostwa dla listy użytkowników.
get GET /v1/{name=customers/*/userLists/*}
Pobiera wybraną listę użytkowników zarządzaną Centrum danych reklam.
list GET /v1/{parent=customers/*}/userLists
Wyświetla listy użytkowników zarządzane przez określonego klienta Centrum danych reklam.
patch PATCH /v1/{userList.name=customers/*/userLists/*}
Aktualizuje żądaną listę użytkowników zarządzaną Centrum danych reklam.
removeRecipients POST /v1/{userList=customers/*/userLists/*}:removeRecipients
Usuwa encje z listy użytkowników zarządzanych przez Centrum danych reklam.

Zasób REST: v1.operations

Metody
cancel POST /v1/{name=operations/**}:cancel
Rozpoczyna asynchroniczne anulowanie w trakcie długo trwającej operacji.
delete DELETE /v1/{name=operations/**}
Usuwa długo trwającą operację.
get GET /v1/{name=operations/**}
Pobiera najnowszy stan długo trwającej operacji.
list GET /v1/{name}
Wyświetla listę operacji pasujących do określonego filtra w żądaniu.
wait POST /v1/{name=operations/**}:wait
Poczeka, aż określona długoterminowa operacja zostanie zakończona lub osiągnie maksymalny czas oczekiwania (w odpowiedzi na ostatni stan).

Zasób REST: v1.outage

Metody
list GET /v1/outages
Wyświetla przerwy w działaniu w kolejności malejącej według sygnatury czasowej rozpoczęcia, a okres ważności wynosi 130 dni.