WebhookNotification

یک منبع عملیات طولانی‌مدت را برای ارسال اعلان وب هوک از Google Analytics Data API به سرور وب هوک شما هنگام به‌روزرسانی منبع پیکربندی می‌کند.

پیکربندی‌های اعلان حاوی مقادیر خصوصی هستند و فقط برای پروژه GCP شما قابل مشاهده هستند. پروژه های مختلف GCP ممکن است اعلان های مختلف وب هوک را به یک منبع عملیات طولانی مدت متصل کنند.

نمایندگی JSON
{
  "uri": string,
  "channelToken": string
}
زمینه های
uri

string

اختیاری. آدرس وب که اعلان وب هوک را دریافت می کند. با تغییر وضعیت منابع عملیات طولانی مدت، این آدرس درخواست های POST را دریافت می کند. درخواست POST شامل یک نسخه JSON از منبع عملیات طولانی در بدنه و یک فیلد sentTimestamp خواهد بود. مهر زمانی ارسال شده، میکروثانیه های یونیکس را از زمان ارسال درخواست مشخص می کند. این به شما امکان می دهد اعلان های پخش شده را شناسایی کنید.

یک URI نمونه https://us-central1-example-project-id.cloudfunctions.net/example-function-1 است.

URI باید از HTTPS استفاده کند و به سایتی با گواهینامه SSL معتبر در سرور وب اشاره کند. URI باید حداکثر طول رشته 128 کاراکتر داشته باشد و فقط از کاراکترهای مجاز RFC 1738 استفاده کند.

هنگامی که سرور وب هوک شما اعلان دریافت می کند، انتظار می رود که در عرض 5 ثانیه با کد وضعیت پاسخ HTTP 200 پاسخ دهد.

یک URI برای استفاده از اعلان‌های وب هوک لازم است.

درخواست‌ها به این سرور وب هوک حاوی یک رمز شناسه است که اعتبار حساب سرویس google-analytics-audience-export@system.gserviceaccount.com را تأیید می‌کند. برای کسب اطلاعات بیشتر درباره نشانه‌های شناسه، به https://cloud.google.com/docs/authentication/token-types#id مراجعه کنید. برای توابع Google Cloud، این به شما امکان می دهد عملکرد خود را طوری پیکربندی کنید که نیاز به احراز هویت داشته باشد. در Cloud IAM، باید مجوزهای حساب سرویس را به Cloud Run Invoker ( roles/run.invoker ) و Cloud Functions Invoker ( roles/cloudfunctions.invoker ) برای درخواست پست webhook بدهید تا احراز هویت Google Cloud Functions را انجام دهد. این API می‌تواند اعلان‌های webhook را به URI‌های دلخواه ارسال کند. برای سرورهای وب هوک غیر از Google Cloud Functions، در صورت عدم نیاز، این رمز شناسه در هدر حامل مجوز باید نادیده گرفته شود.

channelToken

string

اختیاری. نشانه کانال یک مقدار رشته دلخواه است و باید حداکثر طول رشته 64 کاراکتر داشته باشد. توکن های کانال به شما امکان می دهند منبع اعلان وب هوک را تأیید کنید. این از جعل شدن پیام محافظت می کند. توکن کانال در هدر HTTP X-Goog-Channel-Token درخواست webhook POST مشخص خواهد شد.

برای استفاده از اعلان‌های وب هوک نیازی به توکن کانال نیست.