WebhookNotification

Настраивает ресурс длительной работы для отправки уведомления веб-перехватчика из API данных Google Analytics на ваш сервер веб-перехватчиков при обновлении ресурса.

Конфигурации уведомлений содержат частные значения и видны только вашему проекту GCP. Разные проекты GCP могут прикреплять разные уведомления веб-перехватчиков к одному и тому же ресурсу длительной операции.

JSON-представление
{
  "uri": string,
  "channelToken": string
}
Поля
uri

string

Необязательный. Веб-адрес, на который будет получено уведомление веб-перехватчика. Этот адрес будет получать запросы POST при изменении состояния ресурса длительной операции. Запрос POST будет содержать как JSON-версию ресурса длительной операции в теле, так и поле sentTimestamp . В отправленной временной метке будут указаны микросекунды unix с момента отправки запроса; это позволяет идентифицировать воспроизводимые уведомления.

Пример URI: https://us-central1-example-project-id.cloudfunctions.net/example-function-1 .

URI должен использовать HTTPS и указывать на сайт с действительным сертификатом SSL на веб-сервере. URI должен иметь максимальную длину строки 128 символов и использовать только символы из разрешенного списка из RFC 1738 .

Когда ваш сервер веб-перехватчиков получает уведомление, ожидается, что он ответит кодом состояния ответа HTTP 200 в течение 5 секунд.

Для использования уведомлений веб-перехватчика требуется URI.

Запросы к этому серверу веб-перехватчика будут содержать идентификационный токен, подтверждающий подлинность сервисного аккаунта google-analytics-audience-export@system.gserviceaccount.com . Дополнительную информацию о токенах идентификатора см. на странице https://cloud.google.com/docs/authentication/token-types#id . Для облачных функций Google это позволяет настроить функцию так, чтобы она требовала аутентификации. В Cloud IAM вам потребуется предоставить разрешения учетной записи службы ролям Cloud Run Invoker ( roles/run.invoker ) и Cloud Functions Invoker ( roles/cloudfunctions.invoker ), чтобы запрос на публикацию веб-перехватчика мог пройти аутентификацию Google Cloud Functions. Этот API может отправлять уведомления веб-перехватчика на произвольные URI; для серверов веб-перехватчиков, отличных от Google Cloud Functions, этот токен идентификатора в заголовке носителя авторизации следует игнорировать, если он не нужен.

channelToken

string

Необязательный. Токен канала представляет собой произвольное строковое значение и должен иметь максимальную длину строки 64 символа. Токены канала позволяют вам проверить источник уведомления веб-перехватчика. Это защищает сообщение от подделки. Токен канала будет указан в HTTP-заголовке X-Goog-Channel-Token POST-запроса веб-перехватчика.

Токен канала не требуется для использования уведомлений веб-перехватчика.