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 bir 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 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. Bu adres, uzun süreli işlem kaynağının durumu değiştikçe POST istekleri alır. POST isteği, gövdede hem uzun çalışan işlem kaynağının JSON sürümünü hem de sentTimestamp alanını içerir. Gönderilen zaman damgası, isteğin gönderildiği dönemden bu yana geçen unix mikrosaniyeyi belirtir. bu, tekrar oynatılan bildirimleri tanımlamanızı sağlar. https://us-central1-example-project-id.cloudfunctions.net/example-function-1 URI'sı buna örnek olarak verilebilir.
URI, HTTPS kullanmalı ve web sunucusunda geçerli bir SSL sertifikası olan bir siteyi göstermelidir. URI'nın en fazla 128 karakter uzunluğunda bir dize olması gerekir. yalnızca RFC 1738'de izin verilenler listesindeki karakterleri kullanın. Webhook sunucunuz bir bildirim aldığında, 5 saniye içinde 200 kodlu bir HTTP yanıt durum koduyla yanıt vermesi beklenir. Webhook bildirimlerini kullanmak için URI gereklidir. Bu webhook sunucusuna gönderilen istekler, google-analytics-audience-export@system.gserviceaccount.com hizmet hesabını doğrulayan bir kimlik jetonu içerecek. 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. Cloud IAM'de hizmet hesabı izinlerini Cloud Run Çağırıcısı'na (roles/run.invoker ) ve Google Cloud Functions kimlik doğrulamasını geçen webhook yayını isteği için Cloud Functions Çağırıcısı (roles/cloudfunctions.invoker ) rolleri. Bu API, rastgele URI'lere webhook bildirimleri gönderebilir; Yetkilendirme sahibi başlığındaki bu kimlik jetonu, gerekli değilse yoksayılmalıdır.
|
channelToken |
string
İsteğe bağlı. Kanal jetonu rastgele bir dize değeridir ve en fazla 64 karakter uzunluğunda olmalıdır. Kanal jetonları, bir webhook bildiriminin kaynağını doğrulamanıza olanak tanır. Bu da iletinin adres sahteciliğine maruz bırakılmasına karşı koruma sağlar. Kanal jetonu, webhook POST isteğinin X-Goog-Channel-Token HTTP başlığında belirtilir. Webhook bildirimlerini kullanmak için kanal jetonu gerekli değildir.
|
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: 2024-08-24 UTC.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2024-08-24 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."]]],[]]