Ads Data Hub API

API para ejecutar consultas del Centro de Datos de Anuncios.

Servicio: adsdatahub.googleapis.com

Para llamar a este servicio, te recomendamos usar las bibliotecas cliente que proporciona Google. Si tu aplicación necesita usar tus propias bibliotecas para llamar a este servicio, usa la siguiente información cuando realices las solicitudes a la API.

Documento de descubrimiento

Un Documento de descubrimiento es una especificación procesable para describir y consumir las API de REST. Se usa para compilar bibliotecas cliente, complementos IDE y otras herramientas que interactúan con las API de Google. Un servicio puede proporcionar varios documentos de descubrimiento. Este servicio proporciona el siguiente documento de descubrimiento:

Extremo de servicio

Un extremo de servicio es una URL base que especifica la dirección de la red de un servicio de API. Un servicio puede tener varios extremos de servicio. Este servicio tiene el siguiente extremo, y todos los URI que se muestran a continuación son relativos a él:

  • https://adsdatahub.googleapis.com

Recurso de REST: v1.customers

Métodos
describeValidDv360AdvertiserIds POST /v1/{customer=customers/*}:describeValidDv360AdvertiserIds
Describe los ID de anunciante de DV360 válidos
describeValidFrequencyLimitingEventMatchers GET /v1/{customer=customers/*}:describeValidFrequencyLimitingEventMatchers
Enumera los comparadores de eventos válidos junto con sus metadatos para las listas de público de limitación de frecuencia.
exportJobHistory POST /v1/{customer=customers/*}:exportJobHistory
Exporta el historial de trabajos de una cuenta de cliente al conjunto de datos de BigQuery seleccionado por el cliente.
generateDv360IvtVideoViewabilityReport POST /v1/{customer=customers/*}:generateDv360IvtVideoViewabilityReport
Inicia la ejecución de una consulta a fin de recuperar métricas de visibilidad de tráfico no válidas para la plataforma DV360.
generateIvtReport POST /v1/{name=customers/*}:generateIvtReport
Inicia la ejecución de una consulta para recuperar un resumen diario de los recuentos de tráfico no válido de una plataforma específica.
get GET /v1/{name=customers/*}
Recupera el cliente del Centro de Datos de Anuncios solicitado.
getImportCompletionStatus GET /v1/{customer=customers/*}/importCompletionStatus
Muestra el porcentaje de datos de Google de todos los clientes que se transfirieron correctamente al CDA en la fecha determinada.
list GET /v1/customers
Enumera los clientes del Centro de Datos de Anuncios a los que tiene acceso el usuario actual.

Recurso de REST: v1.customers.adsDataCustomers

Métodos
get GET /v1/{name=customers/*/adsDataCustomers/*}
Recupera el cliente del Centro de Datos de Anuncios solicitado.
getDataAccessBudget GET /v1/{name=customers/*/adsDataCustomers/*/dataAccessBudget}
Recupera el presupuesto de acceso a los datos de la fuente de datos de anuncios solicitada para los últimos 366 días.
list GET /v1/{parent=customers/*}/adsDataCustomers
Enumera los datos de anuncios a los que los clientes pueden acceder desde el cliente.

Recurso de REST: v1.customers.analysisQueries

Métodos
create POST /v1/{parent=customers/*}/analysisQueries
Crea una consulta de análisis para su ejecución posterior.
delete DELETE /v1/{name=customers/*/analysisQueries/*}
Borra una consulta de análisis.
get GET /v1/{name=customers/*/analysisQueries/*}
Recupera la consulta de análisis solicitada.
list GET /v1/{parent=customers/*}/analysisQueries
Enumera las consultas de análisis que pertenecen al cliente especificado.
patch PATCH /v1/{query.name=customers/*/analysisQueries/*}
Actualiza una consulta de análisis existente.
start POST /v1/{name=customers/*/analysisQueries/*}:start
Inicia la ejecución en una consulta de análisis almacenada.
startTransient POST /v1/{parent=customers/*}/analysisQueries:startTransient
Inicia la ejecución en una consulta de análisis transitoria.
validate POST /v1/{parent=customers/*}/analysisQueries:validate
Realiza verificaciones de validación estáticas en la consulta de análisis proporcionada.

Recurso de REST: v1.customers.customBiddingAlgorithms

Métodos
addAdvertiser POST /v1/{customBiddingAlgorithm=customers/*/customBiddingAlgorithms/*}:addAdvertiser
Agregue un anunciante de DV360 a los anunciantes del algoritmo de ofertas personalizadas.
create POST /v1/{parent=customers/*}/customBiddingAlgorithms
Crea un algoritmo de ofertas personalizadas administradas por el Centro de Datos de Anuncios.
delete DELETE /v1/{name=customers/*/customBiddingAlgorithms/*}
Borre este algoritmo de ofertas personalizadas.
execute POST /v1/{name=customers/*/customBiddingAlgorithms/*}:execute
Puntúa los últimos 30 días de impresiones para los modelos de ofertas personalizadas.
get GET /v1/{name=customers/*/customBiddingAlgorithms/*}
Recupera el algoritmo de ofertas personalizadas administrado de Ads Data Hub.
list GET /v1/{parent=customers/*}/customBiddingAlgorithms
Enumera los algoritmos de ofertas personalizadas que administra el cliente del Centro de Datos de Anuncios.
patch PATCH /v1/{customBiddingAlgorithm.name=customers/*/customBiddingAlgorithms/*}
Actualiza el algoritmo de ofertas personalizadas administrado de Ads Data Hub solicitado.
removeAdvertiser POST /v1/{customBiddingAlgorithm=customers/*/customBiddingAlgorithms/*}:removeAdvertiser
Quite un anunciante de DV360 de los anunciantes del algoritmo de ofertas personalizadas.

Recurso de REST: v1.customers.tables

Métodos
get GET /v1/{name=customers/*/tables/*}
Recupera la tabla solicitada del Centro de Datos de Anuncios.
list GET /v1/{parent=customers/*}/tables
Enumera las tablas del Centro de Datos de Anuncios a las que tiene acceso el cliente especificado.

Recurso de REST: v1.customers.tempTables

Métodos
get GET /v1/{name=customers/*/tempTables/*}
Recupera la tabla temporal solicitada del Centro de Datos de Anuncios.
list GET /v1/{parent=customers/*}/tempTables
Enumera las tablas temporales del Centro de Datos de Anuncios que creó el cliente.

Recurso de REST: v1.customers.userListQueries

Métodos
create POST /v1/{parent=customers/*}/userListQueries
Crea una consulta de lista de usuarios para su ejecución posterior.
delete DELETE /v1/{name=customers/*/userListQueries/*}
Borra una consulta de lista de usuarios.
get GET /v1/{name=customers/*/userListQueries/*}
Recupera la consulta de la lista de usuarios solicitada.
list GET /v1/{parent=customers/*}/userListQueries
Enumera las consultas de lista de usuarios que son propiedad del cliente especificado.
patch PATCH /v1/{query.name=customers/*/userListQueries/*}
Actualiza una consulta de lista de usuarios existente.
start POST /v1/{name=customers/*/userListQueries/*}:start
Inicia la ejecución en una consulta de lista de usuarios almacenada.
startTransient
(deprecated)		 POST /v1/{parent=customers/*}/userListQueries:startTransient
Inicia la ejecución en una consulta transitoria de la lista de usuarios.
validate POST /v1/{parent=customers/*}/userListQueries:validate
Realiza verificaciones de validación estáticas en la consulta de lista de usuarios proporcionada.

Recurso de REST: v1.customers.userLists

Métodos
addEventMatchers POST /v1/{userList=customers/*/userLists/*}:addEventMatchers
Agrega comparadores de eventos a una lista de usuarios basada en la frecuencia.
addRecipients POST /v1/{userList=customers/*/userLists/*}:addRecipients
Agregue entidades a los destinatarios de una lista de usuarios administradas por el Centro de Datos de Anuncios.
create POST /v1/{parent=customers/*}/userLists
Crea una lista de usuarios administrada por Ads Data Hub.
delete DELETE /v1/{name=customers/*/userLists/*}
Borra la lista de usuarios administrada de Ads Data Hub solicitado.
generateFrequencyListMemberships POST /v1/{name=customers/*/userLists/*}:generateFrequencyListMemberships
Genera membresías para la lista de usuarios.
get GET /v1/{name=customers/*/userLists/*}
Recupera la lista de usuarios administrada de Ads Data Hub administrado.
list GET /v1/{parent=customers/*}/userLists
Enumera las listas de usuarios administradas por el cliente de Ads Data Hub especificado.
patch PATCH /v1/{userList.name=customers/*/userLists/*}
Actualiza la lista de usuarios administrada de Ads Data Hub solicitado.
removeRecipients POST /v1/{userList=customers/*/userLists/*}:removeRecipients
Quita entidades de los destinatarios de una lista de usuarios administradas por el Centro de Datos de Anuncios.

Recurso de REST: v1.operations

Métodos
cancel POST /v1/{name=operations/**}:cancel
Inicia la cancelación asincrónica en una operación de larga duración.
delete DELETE /v1/{name=operations/**}
Borra una operación de larga duración.
get GET /v1/{name=operations/**}
Obtiene el último estado de una operación de larga duración.
list GET /v1/{name}
Enumera las operaciones que coinciden con el filtro especificado en la solicitud.
wait POST /v1/{name=operations/**}:wait
Espera hasta que se completa la operación de larga duración especificada o alcanza, como máximo, un tiempo de espera especificado, y muestra el estado más reciente.

Recurso de REST: v1.outages

Métodos
list GET /v1/outages
Enumera las interrupciones en orden descendente según la marca de tiempo de inicio de la interrupción. La ventana de visualización es de 130 días.