Ads Data Hub API

API para executar consultas do Ads Data Hub.

Serviço: adsdatahub.googleapis.com

Para chamar esse serviço, use as bibliotecas de cliente fornecidas pelo Google. Se o aplicativo precisar usar suas próprias bibliotecas para chamar esse serviço, use as informações a seguir ao fazer as solicitações de API.

Documento de descoberta

Um Documento de descoberta é uma especificação legível por máquina para descrever e consumir APIs REST. Ele é usado para criar bibliotecas de cliente, plug-ins IDE e outras ferramentas que interagem com as APIs do Google. Um serviço pode fornecer vários documentos de descoberta. O serviço fornece o seguinte documento de descoberta:

Endpoint de serviço

Um endpoint de serviço é um URL base que especifica o endereço de rede de um serviço de API. Um serviço pode ter vários endpoints de serviço. Este serviço tem o endpoint a seguir e todos os URIs abaixo são relativos a ele:

  • https://adsdatahub.googleapis.com

Recurso REST: v1.customers

Métodos
describeValidDv360AdvertiserIds POST /v1/{customer=customers/*}:describeValidDv360AdvertiserIds
Descreve os IDs de anunciantes válidos do DV360
describeValidFrequencyLimitingEventMatchers GET /v1/{customer=customers/*}:describeValidFrequencyLimitingEventMatchers
Lista listas de eventos válidos e metadados para listas de público-alvo com limite de frequência.
exportJobHistory POST /v1/{customer=customers/*}:exportJobHistory
Exporta o histórico de jobs de uma conta do cliente para o conjunto de dados do BigQuery selecionado pelo cliente.
generateDv360IvtVideoViewabilityReport POST /v1/{customer=customers/*}:generateDv360IvtVideoViewabilityReport
Inicia a execução de uma consulta para recuperar métricas de visibilidade de tráfego inválidas da plataforma DV360.
generateIvtReport POST /v1/{name=customers/*}:generateIvtReport
Inicia a execução de uma consulta para recuperar um resumo diário de contagens de tráfego inválido de uma plataforma específica.
get GET /v1/{name=customers/*}
Recupera o cliente do Ads Data Hub solicitado.
getImportCompletionStatus GET /v1/{customer=customers/*}/importCompletionStatus
Retorna a porcentagem de dados do Google de todos os clientes que foram ingeridos no ADH na data especificada.
list GET /v1/customers
Lista clientes do Ads Data Hub aos quais o usuário atual tem acesso.

Recurso REST: v1.customers.adsDataCustomers

Métodos
get GET /v1/{name=customers/*/adsDataCustomers/*}
Recupera o cliente do Ads Data Hub solicitado.
getDataAccessBudget GET /v1/{name=customers/*/adsDataCustomers/*/dataAccessBudget}
Recupera o orçamento de acesso a dados para a origem de dados dos anúncios solicitados nos últimos 366 dias.
list GET /v1/{parent=customers/*}/adsDataCustomers
Lista os dados de anúncios que os clientes podem acessar a partir do cliente.

Recurso REST: v1.customers.analysisQuery

Métodos
create POST /v1/{parent=customers/*}/analysisQueries
Cria uma consulta de análise para execução posterior.
delete DELETE /v1/{name=customers/*/analysisQueries/*}
Exclui uma consulta de análise.
get GET /v1/{name=customers/*/analysisQueries/*}
Recupera a consulta de análise solicitada.
list GET /v1/{parent=customers/*}/analysisQueries
Lista as consultas de análise que pertencem ao cliente especificado.
patch PATCH /v1/{query.name=customers/*/analysisQueries/*}
Atualiza uma consulta de análise existente.
start POST /v1/{name=customers/*/analysisQueries/*}:start
Inicia a execução em uma consulta de análise armazenada.
startTransient POST /v1/{parent=customers/*}/analysisQueries:startTransient
Inicia a execução em uma consulta de análise temporária.
validate POST /v1/{parent=customers/*}/analysisQueries:validate
Realiza verificações de validação estáticas na consulta de análise fornecida.

Recurso REST: v1.customers.customBiddingAlgorithms

Métodos
addAdvertiser POST /v1/{customBiddingAlgorithm=customers/*/customBiddingAlgorithms/*}:addAdvertiser
Adicione um anunciante do DV360 aos anunciantes do algoritmo de lances personalizados.
create POST /v1/{parent=customers/*}/customBiddingAlgorithms
Cria um algoritmo de lance personalizado gerenciado pelo Ads Data Hub.
delete DELETE /v1/{name=customers/*/customBiddingAlgorithms/*}
Exclua esse algoritmo de lance personalizado.
execute POST /v1/{name=customers/*/customBiddingAlgorithms/*}:execute
Pontuação dos últimos 30 dias de impressões dos modelos de lances personalizados.
get GET /v1/{name=customers/*/customBiddingAlgorithms/*}
Recupera o algoritmo de lances personalizados gerenciado pelo Ads Data Hub.
list GET /v1/{parent=customers/*}/customBiddingAlgorithms
Lista os algoritmos de lances personalizados gerenciados pelo cliente especificado do Ads Data Hub.
patch PATCH /v1/{customBiddingAlgorithm.name=customers/*/customBiddingAlgorithms/*}
Atualiza o algoritmo de lance personalizado gerenciado pelo Ads Data Hub.
removeAdvertiser POST /v1/{customBiddingAlgorithm=customers/*/customBiddingAlgorithms/*}:removeAdvertiser
Remover um anunciante do DV360 dos anunciantes do algoritmo de lances personalizados.

Recurso REST: v1.customers.tables

Métodos
get GET /v1/{name=customers/*/tables/*}
Recupera a tabela do Ads Data Hub solicitada.
list GET /v1/{parent=customers/*}/tables
Lista as tabelas do Ads Data Hub a que o cliente especificado tem acesso.

Recurso REST: v1.customers.tempTables

Métodos
get GET /v1/{name=customers/*/tempTables/*}
Recupera a tabela temporária do Ads Data Hub solicitada.
list GET /v1/{parent=customers/*}/tempTables
Lista as tabelas temporárias do Ads Data Hub que o cliente criou.

Recurso REST: v1.customers.userListQuery

Métodos
create POST /v1/{parent=customers/*}/userListQueries
Cria uma consulta de lista de usuários para execução posterior.
delete DELETE /v1/{name=customers/*/userListQueries/*}
Exclui uma consulta da lista de usuários.
get GET /v1/{name=customers/*/userListQueries/*}
Recupera a consulta da lista de usuários solicitada.
list GET /v1/{parent=customers/*}/userListQueries
Lista as consultas da lista de usuários do cliente especificado.
patch PATCH /v1/{query.name=customers/*/userListQueries/*}
Atualiza uma consulta da lista de usuários existente.
start POST /v1/{name=customers/*/userListQueries/*}:start
Inicia a execução em uma consulta de lista de usuários armazenada.
startTransient
(deprecated)		 POST /v1/{parent=customers/*}/userListQueries:startTransient
Inicia a execução em uma consulta de lista de usuários temporária.
validate POST /v1/{parent=customers/*}/userListQueries:validate
Realiza verificações de validação estáticas na consulta da lista de usuários fornecida.

Recurso REST: v1.customers.userLists

Métodos
addEventMatchers POST /v1/{userList=customers/*/userLists/*}:addEventMatchers
Adiciona correspondentes de eventos a uma lista de usuários com base em frequência.
addRecipients POST /v1/{userList=customers/*/userLists/*}:addRecipients
Adicione entidades aos destinatários de uma lista de usuários gerenciada pelo Ads Data Hub.
create POST /v1/{parent=customers/*}/userLists
Cria uma lista de usuários gerenciada pelo Ads Data Hub.
delete DELETE /v1/{name=customers/*/userLists/*}
Exclua a lista de usuários solicitadas do Ads Data Hub gerenciada.
generateFrequencyListMemberships POST /v1/{name=customers/*/userLists/*}:generateFrequencyListMemberships
Gere assinaturas para a lista de usuários.
get GET /v1/{name=customers/*/userLists/*}
Recupera a lista de usuários solicitada do Ads Data Hub gerenciada.
list GET /v1/{parent=customers/*}/userLists
Lista as listas de usuários gerenciadas pelo cliente especificado do Ads Data Hub.
patch PATCH /v1/{userList.name=customers/*/userLists/*}
Atualiza a lista de usuários solicitadas do Ads Data Hub gerenciada.
removeRecipients POST /v1/{userList=customers/*/userLists/*}:removeRecipients
Remove entidades de destinatários de uma lista de usuários gerenciada pelo Ads Data Hub.

Recurso REST: v1.operations

Métodos
cancel POST /v1/{name=operations/**}:cancel
Inicia o cancelamento assíncrono em uma operação de longa duração.
delete DELETE /v1/{name=operations/**}
Exclui uma operação de longa duração.
get GET /v1/{name=operations/**}
Recebe o estado mais recente de uma operação de longa duração.
list GET /v1/{name}
Lista as operações que correspondem ao filtro especificado na solicitação.
wait POST /v1/{name=operations/**}:wait
Aguarda até que a operação de longa duração especificada seja concluída ou atinja, no máximo, um tempo limite especificado, retornando o estado mais recente.

Recurso REST: v1.outages

Métodos
list GET /v1/outages
Lista as falhas temporárias em ordem decrescente de início do período de falha e a janela de lookback é de 130 dias.