Попробуйте сервер MCP для Google Analytics. Установите его с
GitHub и ознакомьтесь с
анонсом для получения более подробной информации.
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 и ее аффилированных лиц.
Последнее обновление: 2025-07-24 UTC.
[null,null,["Последнее обновление: 2025-07-24 UTC."],[[["\u003cp\u003eWebhook notifications can be configured for long-running operations in the Google Analytics Data API to send updates to your server.\u003c/p\u003e\n"],["\u003cp\u003eThese notifications are project-specific and include a JSON payload with operation details and a timestamp.\u003c/p\u003e\n"],["\u003cp\u003eThe webhook configuration requires a URI using HTTPS with a valid SSL certificate, and optionally, a channel token for verification.\u003c/p\u003e\n"],["\u003cp\u003eWhen receiving a notification, your server should respond with an HTTP 200 status code within 5 seconds.\u003c/p\u003e\n"],["\u003cp\u003eAuthentication for Google Cloud Functions is provided through an ID token representing the service account \u003ccode\u003egoogle-analytics-audience-export@system.gserviceaccount.com\u003c/code\u003e, while other webhook servers can ignore this token.\u003c/p\u003e\n"]]],["This document outlines the configuration for webhook notifications from the Google Analytics Data API. You can set up a webhook server (`uri`) to receive POST requests containing long-running operation resource updates in JSON format, along with a `sentTimestamp`. The `uri` must be HTTPS with a valid SSL certificate and is required for webhook notifications. Optionally, use a `channelToken` for source verification, which is included in the `X-Goog-Channel-Token` header. Notifications will include an ID token for authentication.\n"],null,["# WebhookNotification\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n\nConfigures a long-running operation resource to send a webhook notification from the Google Analytics Data API to your webhook server when the resource updates.\n\nNotification configurations contain private values \\& are only visible to your GCP project. Different GCP projects may attach different webhook notifications to the same long-running operation resource.\n\n| JSON representation |\n|---------------------------------------------------|\n| ``` { \"uri\": string, \"channelToken\": string } ``` |\n\n| Fields ||\n|------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `uri` | `string` Optional. The web address that will receive the webhook notification. This address will receive POST requests as the state of the long running operation resource changes. The POST request will contain both a JSON version of the long running operation resource in the body and a `sentTimestamp` field. The sent timestamp will specify the unix microseconds since the epoch that the request was sent; this lets you identify replayed notifications. An example URI is `https://us-central1-example-project-id.cloudfunctions.net/example-function-1`. The URI must use HTTPS and point to a site with a valid SSL certificate on the web server. The URI must have a maximum string length of 128 characters \\& use only the allowlisted characters from [RFC 1738](https://www.rfc-editor.org/rfc/rfc1738). When your webhook server receives a notification, it is expected to reply with an HTTP response status code of 200 within 5 seconds. A URI is required to use webhook notifications. Requests to this webhook server will contain an ID token authenticating the service account `google-analytics-audience-export@system.gserviceaccount.com`. To learn more about ID tokens, see \u003chttps://cloud.google.com/docs/authentication/token-types#id\u003e. For Google Cloud Functions, this lets you configure your function to require authentication. In Cloud IAM, you will need to grant the service account permissions to the Cloud Run Invoker (`roles/run.invoker`) \\& Cloud Functions Invoker (`roles/cloudfunctions.invoker`) roles for the webhook post request to pass Google Cloud Functions authentication. This API can send webhook notifications to arbitrary URIs; for webhook servers other than Google Cloud Functions, this ID token in the authorization bearer header should be ignored if it is not needed. |\n| `channel``Token` | `string` Optional. The channel token is an arbitrary string value and must have a maximum string length of 64 characters. Channel tokens allow you to verify the source of a webhook notification. This guards against the message being spoofed. The channel token will be specified in the `X-Goog-Channel-Token` HTTP header of the webhook POST request. A channel token is not required to use webhook notifications. |"]]
