Ads Data Hub API

API для выполнения запросов Ads Data Hub.

Сервис: adsdatahub.googleapis.com

Для вызова этой службы рекомендуется использовать клиентские библиотеки , предоставленные Google. Если вашему приложению необходимо использовать собственные библиотеки для вызова этой службы, используйте следующую информацию при отправке запросов API.

Документ обнаружения

Discovery Document — это машиночитаемая спецификация для описания и использования REST API. Он используется для создания клиентских библиотек, подключаемых модулей IDE и других инструментов, взаимодействующих с API Google. Одна служба может предоставлять несколько документов обнаружения. Эта служба предоставляет следующий документ обнаружения:

Конечная точка службы

Конечная точка службы — это базовый URL-адрес, указывающий сетевой адрес службы API. Одна служба может иметь несколько конечных точек службы. Эта служба имеет следующую конечную точку службы, и все приведенные ниже URI относятся к этой конечной точке службы:

  • https://adsdatahub.googleapis.com

Ресурс REST: v1.customers

Методы
describeValidDv360AdvertiserIds POST /v1/{customer=customers/*}:describeValidDv360AdvertiserIds
Описывает действительные идентификаторы рекламодателя DV360.
describeValidFrequencyLimitingEventMatchers GET /v1/{customer=customers/*}:describeValidFrequencyLimitingEventMatchers
Список действительных сопоставителей событий вместе с их метаданными для списков аудитории с ограничением частоты показов.
exportJobHistory POST /v1/{customer=customers/*}:exportJobHistory
Экспортирует историю заданий учетной записи клиента в выбранный клиентом набор данных BigQuery.
generateDv360IvtVideoViewabilityReport POST /v1/{customer=customers/*}:generateDv360IvtVideoViewabilityReport
Запускает выполнение запроса для получения недопустимых показателей видимости трафика для платформы DV360.
generateIvtReport POST /v1/{name=customers/*}:generateIvtReport
Запускает выполнение запроса для получения ежедневной сводки о количестве недействительного трафика для определенной платформы.
get GET /v1/{name=customers/*}
Извлекает запрошенного клиента Ads Data Hub.
getImportCompletionStatus GET /v1/{customer=customers/*}/importCompletionStatus
Возвращает процент данных Google по всем клиентам, которые были успешно загружены в ADH на заданную дату.
list GET /v1/customers
Список клиентов Ads Data Hub, к которым у текущего пользователя есть доступ.

Ресурс REST: v1.customers.adsDataCustomers

Методы
get GET /v1/{name=customers/*/adsDataCustomers/*}
Извлекает запрошенного клиента Ads Data Hub.
getDataAccessBudget GET /v1/{name=customers/*/adsDataCustomers/*/dataAccessBudget}
Получает бюджет доступа к данным для запрошенного источника данных объявлений за последние 366 дней.
list GET /v1/{parent=customers/*}/adsDataCustomers
Перечисляет клиентов данных рекламы, доступных от клиента.

Ресурс REST: v1.customers.analysisQueries

Методы
create POST /v1/{parent=customers/*}/analysisQueries
Создает запрос анализа для последующего выполнения.
delete DELETE /v1/{name=customers/*/analysisQueries/*}
Удаляет запрос анализа.
get GET /v1/{name=customers/*/analysisQueries/*}
Извлекает запрошенный аналитический запрос.
list GET /v1/{parent=customers/*}/analysisQueries
Список запросов анализа, принадлежащих указанному клиенту.
patch PATCH /v1/{query.name=customers/*/analysisQueries/*}
Обновляет существующий запрос анализа.
start POST /v1/{name=customers/*/analysisQueries/*}:start
Запускает выполнение сохраненного запроса анализа.
startTransient POST /v1/{parent=customers/*}/analysisQueries:startTransient
Запускает выполнение запроса анализа переходных процессов.
validate POST /v1/{parent=customers/*}/analysisQueries:validate
Выполняет статическую проверку достоверности предоставленного запроса анализа.

Ресурс REST: v1.customers.customBiddingAlgorithms

Методы
addAdvertiser POST /v1/{customBiddingAlgorithm=customers/*/customBiddingAlgorithms/*}:addAdvertiser
Добавьте рекламодателя DV360 в список рекламодателей пользовательского алгоритма назначения ставок.
create POST /v1/{parent=customers/*}/customBiddingAlgorithms
Создает специальный алгоритм назначения ставок, управляемый Ads Data Hub.
delete DELETE /v1/{name=customers/*/customBiddingAlgorithms/*}
Удалите этот специальный алгоритм назначения ставок.
execute POST /v1/{name=customers/*/customBiddingAlgorithms/*}:execute
Оценивает показы за последние 30 дней для специальных моделей назначения ставок.
get GET /v1/{name=customers/*/customBiddingAlgorithms/*}
Получает запрошенный специальный алгоритм назначения ставок, управляемый Ads Data Hub.
list GET /v1/{parent=customers/*}/customBiddingAlgorithms
Список специальных алгоритмов назначения ставок, которыми управляет указанный клиент Ads Data Hub.
patch PATCH /v1/{customBiddingAlgorithm.name=customers/*/customBiddingAlgorithms/*}
Обновляет запрошенный алгоритм пользовательского назначения ставок, управляемый Ads Data Hub.
removeAdvertiser POST /v1/{customBiddingAlgorithm=customers/*/customBiddingAlgorithms/*}:removeAdvertiser
Удалите рекламодателя DV360 из числа рекламодателей пользовательского алгоритма назначения ставок.

Ресурс REST: v1.customers.tables

Методы
get GET /v1/{name=customers/*/tables/*}
Извлекает запрошенную таблицу Ads Data Hub.
list GET /v1/{parent=customers/*}/tables
Список таблиц Ads Data Hub, к которым у указанного клиента есть доступ.

Ресурс REST: v1.customers.tempTables

Методы
get GET /v1/{name=customers/*/tempTables/*}
Извлекает запрошенную временную таблицу Ads Data Hub.
list GET /v1/{parent=customers/*}/tempTables
Список временных таблиц Ads Data Hub, созданных клиентом.

Ресурс REST: v1.customers.userListQueries

Методы
create POST /v1/{parent=customers/*}/userListQueries
Создает запрос списка пользователей для последующего выполнения.
delete DELETE /v1/{name=customers/*/userListQueries/*}
Удаляет запрос списка пользователей.
get GET /v1/{name=customers/*/userListQueries/*}
Извлекает запрошенный запрос списка пользователей.
list GET /v1/{parent=customers/*}/userListQueries
Список запросов списка пользователей, принадлежащих указанному клиенту.
patch PATCH /v1/{query.name=customers/*/userListQueries/*}
Обновляет существующий запрос списка пользователей.
start POST /v1/{name=customers/*/userListQueries/*}:start
Запускает выполнение сохраненного запроса списка пользователей.
startTransient
(deprecated)		 POST /v1/{parent=customers/*}/userListQueries:startTransient
Начинает выполнение временного запроса списка пользователей.
validate POST /v1/{parent=customers/*}/userListQueries:validate
Выполняет статическую проверку правильности предоставленного запроса списка пользователей.

Ресурс REST: v1.customers.userLists

Методы
addEventMatchers POST /v1/{userList=customers/*/userLists/*}:addEventMatchers
Добавляет сопоставители событий в список пользователей на основе частоты.
addRecipients POST /v1/{userList=customers/*/userLists/*}:addRecipients
Добавляйте объекты в список получателей, управляемый Ads Data Hub.
create POST /v1/{parent=customers/*}/userLists
Создает список пользователей, управляемый Ads Data Hub.
delete DELETE /v1/{name=customers/*/userLists/*}
Удалите запрошенный список пользователей, управляемый Ads Data Hub.
generateFrequencyListMemberships POST /v1/{name=customers/*/userLists/*}:generateFrequencyListMemberships
Создание членства для UserList.
get GET /v1/{name=customers/*/userLists/*}
Получает запрошенный список пользователей, управляемый Ads Data Hub.
list GET /v1/{parent=customers/*}/userLists
Список списков пользователей, которыми управляет указанный клиент Ads Data Hub.
patch PATCH /v1/{userList.name=customers/*/userLists/*}
Обновляет запрошенный список пользователей, управляемый Ads Data Hub.
removeRecipients POST /v1/{userList=customers/*/userLists/*}:removeRecipients
Удаляет объекты из списка получателей, управляемого Ads Data Hub.

Ресурс REST: v1.operations

Методы
cancel POST /v1/{name=operations/**}:cancel
Запускает асинхронную отмену длительной операции.
delete DELETE /v1/{name=operations/**}
Удаляет длительную операцию.
get GET /v1/{name=operations/**}
Получает последнее состояние длительной операции.
list GET /v1/{name}
Перечисляет операции, соответствующие указанному фильтру в запросе.
wait POST /v1/{name=operations/**}:wait
Ожидает, пока не будет выполнена указанная длительная операция или не будет достигнуто не более указанного времени ожидания, возвращая последнее состояние.

Ресурс REST: v1.outages

Методы
list GET /v1/outages
Перечисляет сбои в порядке убывания метки времени начала сбоя, период ретроспективного анализа составляет 130 дней.