Ads Data Hub API

API per l'esecuzione di query Ads Data Hub.

Servizio: adsdatahub.googleapis.com

Per chiamare questo servizio, ti consigliamo di utilizzare le librerie client fornite da Google. Se la tua applicazione deve utilizzare le tue librerie per chiamare questo servizio, usa le seguenti informazioni quando effettui le richieste API.

Documento di rilevamento

Un documento discovery è una specifica leggibile dal computer per descrivere e utilizzare le API REST. Viene utilizzato per creare librerie client, plug-in IDE e altri strumenti che interagiscono con le API di Google. Un servizio può fornire più documenti di rilevamento. Questo servizio fornisce il seguente documento di rilevamento:

Endpoint di servizio

Un endpoint di servizio è un URL di base che specifica l'indirizzo di rete di un servizio API. Un servizio può avere più endpoint di servizio. Questo servizio ha il seguente endpoint di servizio e tutti gli URI seguenti sono relativi a questo endpoint di servizio:

  • https://adsdatahub.googleapis.com

Risorsa REST: v1.customers

Metodi
describeValidDv360AdvertiserIds POST /v1/{customer=customers/*}:describeValidDv360AdvertiserIds
Descrive gli ID inserzionista DV360 validi
describeValidFrequencyLimitingEventMatchers GET /v1/{customer=customers/*}:describeValidFrequencyLimitingEventMatchers
Elenca gli abbinamenti validi degli eventi e i relativi metadati per gli elenchi dei segmenti di pubblico con quota limite.
exportJobHistory POST /v1/{customer=customers/*}:exportJobHistory
Esporta la cronologia dei job di un account cliente in un set di dati BigQuery selezionato dal cliente.
generateDv360IvtVideoViewabilityReport POST /v1/{customer=customers/*}:generateDv360IvtVideoViewabilityReport
Avvia l'esecuzione di una query per recuperare le metriche di visibilità del traffico non valido per la piattaforma DV360.
generateIvtReport POST /v1/{name=customers/*}:generateIvtReport
Avvia l'esecuzione di una query per recuperare un riepilogo giornaliero dei conteggi del traffico non valido per una piattaforma specifica.
get GET /v1/{name=customers/*}
Recupera il cliente Ads Data Hub richiesto.
getImportCompletionStatus GET /v1/{customer=customers/*}/importCompletionStatus
Restituisce la percentuale di dati Google per tutti i clienti che sono stati importati correttamente in ADH alla data specificata.
list GET /v1/customers
Elenca i clienti di Ads Data Hub a cui ha accesso l'utente corrente.

Risorsa REST: v1.customers.adsDataCustomers

Metodi
get GET /v1/{name=customers/*/adsDataCustomers/*}
Recupera il cliente Ads Data Hub richiesto.
getDataAccessBudget GET /v1/{name=customers/*/adsDataCustomers/*/dataAccessBudget}
Recupera il budget di accesso ai dati per l'origine dati degli annunci richiesta negli ultimi 366 giorni.
list GET /v1/{parent=customers/*}/adsDataCustomers
Elenca i dati pubblicitari a cui i clienti possono accedere.

Risorsa REST: v1.customers.analysisQuery

Metodi
create POST /v1/{parent=customers/*}/analysisQueries
Crea una query di analisi per un'esecuzione successiva.
delete DELETE /v1/{name=customers/*/analysisQueries/*}
Elimina una query di analisi.
get GET /v1/{name=customers/*/analysisQueries/*}
Recupera la query di analisi richiesta.
list GET /v1/{parent=customers/*}/analysisQueries
Elenca le query di analisi di proprietà del cliente specificato.
patch PATCH /v1/{query.name=customers/*/analysisQueries/*}
Aggiorna una query di analisi esistente.
start POST /v1/{name=customers/*/analysisQueries/*}:start
Avvia l'esecuzione su una query di analisi archiviata.
startTransient POST /v1/{parent=customers/*}/analysisQueries:startTransient
Avvia l'esecuzione su una query di analisi temporanea.
validate POST /v1/{parent=customers/*}/analysisQueries:validate
Esegue controlli di convalida statici sulla query di analisi fornita.

Risorsa REST: v1.customers.customBiddingAlgorithms

Metodi
addAdvertiser POST /v1/{customBiddingAlgorithm=customers/*/customBiddingAlgorithms/*}:addAdvertiser
Aggiungi un inserzionista DV360 agli inserzionisti dell'algoritmo delle offerte personalizzate.
create POST /v1/{parent=customers/*}/customBiddingAlgorithms
Crea un algoritmo di offerte personalizzate gestito da Ads Data Hub.
delete DELETE /v1/{name=customers/*/customBiddingAlgorithms/*}
Elimina questo algoritmo di offerte personalizzate.
execute POST /v1/{name=customers/*/customBiddingAlgorithms/*}:execute
Assegna un punteggio alle impressioni degli ultimi 30 giorni per i modelli di offerte personalizzate.
get GET /v1/{name=customers/*/customBiddingAlgorithms/*}
Recupera l'algoritmo delle offerte personalizzate gestito da Ads Data Hub.
list GET /v1/{parent=customers/*}/customBiddingAlgorithms
Elenca gli algoritmi di offerta personalizzata gestiti dal cliente Ads Data Hub specificato.
patch PATCH /v1/{customBiddingAlgorithm.name=customers/*/customBiddingAlgorithms/*}
Aggiorna l'algoritmo delle offerte personalizzate gestito da Ads Data Hub.
removeAdvertiser POST /v1/{customBiddingAlgorithm=customers/*/customBiddingAlgorithms/*}:removeAdvertiser
Rimuovi un inserzionista DV360 dall'algoritmo delle offerte personalizzate.

Risorsa REST: v1.customers.tables

Metodi
get GET /v1/{name=customers/*/tables/*}
Recupera la tabella Ads Data Hub richiesta.
list GET /v1/{parent=customers/*}/tables
Elenca le tabelle di Ads Data Hub a cui ha accesso il cliente specificato.

Risorsa REST: v1.customers.tempTables

Metodi
get GET /v1/{name=customers/*/tempTables/*}
Recupera la tabella temporanea relativa ad Ads Data Hub.
list GET /v1/{parent=customers/*}/tempTables
Elenca le tabelle temp di Ads Data Hub create dal cliente.

Risorsa REST: v1.customers.userListQuery

Metodi
create POST /v1/{parent=customers/*}/userListQueries
Crea una query di un elenco di utenti per l'esecuzione successiva.
delete DELETE /v1/{name=customers/*/userListQueries/*}
Elimina una query dell'elenco utenti.
get GET /v1/{name=customers/*/userListQueries/*}
Recupera la query dell'elenco degli utenti richiesta.
list GET /v1/{parent=customers/*}/userListQueries
Elenca le query degli elenchi di utenti di proprietà del cliente specificato.
patch PATCH /v1/{query.name=customers/*/userListQueries/*}
Aggiorna una query esistente per l'elenco utenti.
start POST /v1/{name=customers/*/userListQueries/*}:start
Avvia l'esecuzione su una query memorizzata nell'elenco degli utenti.
startTransient
(deprecated)		 POST /v1/{parent=customers/*}/userListQueries:startTransient
Avvia l'esecuzione su una query temporanea di un elenco di utenti.
validate POST /v1/{parent=customers/*}/userListQueries:validate
Esegue controlli di convalida statici sulla query dell'elenco utenti fornito.

Risorsa REST: v1.customers.userLists

Metodi
addEventMatchers POST /v1/{userList=customers/*/userLists/*}:addEventMatchers
Aggiunge matcher evento a un elenco di utenti basato sulla frequenza.
addRecipients POST /v1/{userList=customers/*/userLists/*}:addRecipients
Aggiungi entità ai destinatari di un elenco di utenti gestito da Ads Data Hub.
create POST /v1/{parent=customers/*}/userLists
Crea un elenco di utenti gestito da Ads Data Hub.
delete DELETE /v1/{name=customers/*/userLists/*}
Elimina l'elenco di utenti gestito da Ads Data Hub richiesto.
generateFrequencyListMemberships POST /v1/{name=customers/*/userLists/*}:generateFrequencyListMemberships
Genera membri per l'elenco utenti.
get GET /v1/{name=customers/*/userLists/*}
Recupera l'elenco di utenti gestito da Ads Data Hub richiesto.
list GET /v1/{parent=customers/*}/userLists
Elenca gli elenchi di utenti gestiti dal cliente Ads Data Hub specificato.
patch PATCH /v1/{userList.name=customers/*/userLists/*}
Aggiorna l'elenco di utenti gestito da Ads Data Hub richiesto.
removeRecipients POST /v1/{userList=customers/*/userLists/*}:removeRecipients
Rimuove le entità dai destinatari di un elenco di utenti gestito da Ads Data Hub.

Risorsa REST: v1.operations

Metodi
cancel POST /v1/{name=operations/**}:cancel
Avvia l'annullamento asincrono in caso di un'operazione a lunga esecuzione.
delete DELETE /v1/{name=operations/**}
Elimina un'operazione a lunga esecuzione.
get GET /v1/{name=operations/**}
Recupera lo stato più recente di un'operazione a lunga esecuzione.
list GET /v1/{name}
Elenca le operazioni che corrispondono al filtro specificato nella richiesta.
wait POST /v1/{name=operations/**}:wait
Attendi fino al completamento dell'operazione a lunga esecuzione specificata o raggiunge al massimo un timeout specificato, restituendo lo stato più recente.

Risorsa REST: v1.outages

Metodi
list GET /v1/outages
Elenca le interruzioni in ordine decrescente del timestamp di inizio dell'interruzione e la finestra temporale di 130 giorni.