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, этот токен идентификатора в заголовке носителя авторизации следует игнорировать, если он не нужен. |
channel Token | string Необязательный. Токен канала представляет собой произвольное строковое значение и должен иметь максимальную длину строки 64 символа. Токены канала позволяют проверить источник уведомления веб-перехватчика. Это защищает сообщение от подделки. Токен канала будет указан в HTTP-заголовке X-Goog-Channel-Token POST-запроса веб-перехватчика. Токен канала не требуется для использования уведомлений веб-перехватчика. |
,
Настраивает ресурс длительной работы для отправки уведомления веб-перехватчика из 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, этот токен идентификатора в заголовке носителя авторизации следует игнорировать, если он не нужен. |
channel Token | string Необязательный. Токен канала представляет собой произвольное строковое значение и должен иметь максимальную длину строки 64 символа. Токены канала позволяют вам проверить источник уведомления веб-перехватчика. Это защищает сообщение от подделки. Токен канала будет указан в HTTP-заголовке X-Goog-Channel-Token POST-запроса веб-перехватчика. Токен канала не требуется для использования уведомлений веб-перехватчика. |
,
Настраивает ресурс длительной работы для отправки уведомления веб-перехватчика из 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, этот токен идентификатора в заголовке носителя авторизации следует игнорировать, если он не нужен. |
channel Token | string Необязательный. Токен канала представляет собой произвольное строковое значение и должен иметь максимальную длину строки 64 символа. Токены канала позволяют проверить источник уведомления веб-перехватчика. Это защищает сообщение от подделки. Токен канала будет указан в HTTP-заголовке X-Goog-Channel-Token POST-запроса веб-перехватчика. Токен канала не требуется для использования уведомлений веб-перехватчика. |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2024-11-20 UTC.
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 2024-11-20 UTC."],[[["Webhook notifications can be configured for long-running operations in the Google Analytics Data API to send updates to your server."],["These notifications are project-specific and include a JSON payload with operation details and a timestamp."],["The webhook configuration requires a URI using HTTPS with a valid SSL certificate, and optionally, a channel token for verification."],["When receiving a notification, your server should respond with an HTTP 200 status code within 5 seconds."],["Authentication for Google Cloud Functions is provided through an ID token representing the service account `google-analytics-audience-export@system.gserviceaccount.com`, while other webhook servers can ignore this token."]]],[]]
