Ads Data Hub API

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

• Zasób REST: v1.customers
• Zasób REST: v1.customers.adsDataCustomers
• Zasób REST: v1.customers.adsDataLinks
• Zasób REST: v1.customers.analysisQuery
• Zasób REST: v1.customers.customBiddingAlgorithms
• Zasób REST: v1.customers.inboundCustomerLinks
• Zasób REST: v1.customers.outboundCustomerLinks
• Zasób REST: v1.customers.tables
• Zasób REST: v1.customers.tempTables
• Zasób REST: v1.customers.userListQuery
• Zasób REST: v1.customers.userLists
• Zasób REST: v1.operations
• Zasób REST: v1.outage

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:

• https://adsdatahub.googleapis.com/$discovery/rest?version=v1

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.adsDataLinks

Metody
batchApprove	POST /v1/{parent=customers/*}/adsDataLinks:batchApprove Zaakceptuj listę oczekujących połączeń z danymi reklam.
batchReject	POST /v1/{parent=customers/*}/adsDataLinks:batchReject Odrzuć listę linków do oczekujących danych z reklam.
list	GET /v1/{parent=customers/*}/adsDataLinks Wyświetla połączenia między określonym klientem a innymi jednostkami reklamowymi Google.

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.inboundCustomerLinks

Metody
list	GET /v1/{parent=customers/*}/inboundCustomerLinks Zawiera listę połączeń, w których inny klient Centrum danych reklam przyznał dostęp określonemu klientowi.

Zasób REST: v1.customers.outboundCustomerLinks

Metody
list	GET /v1/{parent=customers/*}/outboundCustomerLinks Wyświetla linki, w przypadku których dany klient przyznał dostęp innym klientom Centrum danych reklam.

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.