Google Analytics için MCP sunucusunu deneyin.
GitHub'dan yükleyin ve daha fazla bilgi için
duyuruyu inceleyin.
WebhookNotification
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Kaynak güncellendiğinde Google Analytics Data API'den webhook sunucunuza webhook bildirimi göndermek için uzun süreli bir işlem kaynağını yapılandırır.
Bildirim yapılandırmaları gizli değerler içerir ve yalnızca GCP projeniz tarafından görülebilir. Farklı GCP projeleri, aynı uzun süreli işlem kaynağına farklı webhook bildirimleri ekleyebilir.
| JSON gösterimi |
{
"uri": string,
"channelToken": string
} |
| Alanlar |
uri |
string
İsteğe bağlı. Webhook bildirimini alacak web adresi. Uzun süren işlem kaynağının durumu değiştikçe bu adres POST istekleri alır. POST isteği, gövdede hem uzun süren işlem kaynağının JSON sürümünü hem de bir sentTimestamp alanı içerir. Gönderilen zaman damgası, isteğin gönderildiği epoch'tan sonraki unix mikrosaniyelerini belirtir. Bu, yeniden oynatılan bildirimleri belirlemenize olanak tanır. Örnek bir URI: https://us-central1-example-project-id.cloudfunctions.net/example-function-1. URI, HTTPS'yi kullanmalı ve web sunucusunda geçerli bir SSL sertifikası olan bir siteye işaret etmelidir. URI'nin maksimum dize uzunluğu 128 karakter olmalı ve yalnızca RFC 1738'deki izin verilen karakterleri kullanmalıdır. Webhook sunucunuz bir bildirim aldığında 5 saniye içinde 200 HTTP yanıt durum koduyla yanıt vermesi beklenir. Webhook bildirimlerini kullanmak için bir URI gereklidir. Bu webhook sunucusuna gönderilen istekler, google-analytics-audience-export@system.gserviceaccount.com hizmet hesabının kimliğini doğrulayan bir kimlik jetonu içerir. Kimlik jetonları hakkında daha fazla bilgi edinmek için https://cloud.google.com/docs/authentication/token-types#id adresini ziyaret edin. Google Cloud Functions için bu, işlevinizi kimlik doğrulama gerektirecek şekilde yapılandırmanıza olanak tanır. Webhook gönderme isteğinin Google Cloud Functions kimlik doğrulamasını geçmesi için Cloud IAM'da hizmet hesabına Cloud Run Çağırıcı (roles/run.invoker) ve Cloud Functions Çağırıcı (roles/cloudfunctions.invoker) rollerine izin vermeniz gerekir. Bu API, rastgele URI'lere webhook bildirimleri gönderebilir. Google Cloud Functions dışındaki webhook sunucuları için, yetkilendirme taşıyıcı başlığındaki bu kimlik jetonu gerekmiyorsa yoksayılmalıdır.
|
channelToken |
string
İsteğe bağlı. Kanal jetonu, rastgele bir dize değeridir ve maksimum 64 karakter uzunluğunda olmalıdır. Kanal jetonları, webhook bildiriminin kaynağını doğrulamanıza olanak tanır. Bu, mesajın adres sahteciliğine karşı korunmasını sağlar. Kanal jetonu, webhook POST isteğinin X-Goog-Channel-Token HTTP üst bilgisinde belirtilir. Webhook bildirimlerini kullanmak için kanal jetonu gerekmez.
|
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-26 UTC.
[null,null,["Son güncelleme tarihi: 2025-07-26 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. |"]]
