WebhookNotification

تضبط هذه السياسة موردًا لعمليات التشغيل لفترة طويلة لإرسال إشعار ردّ تلقائي على الويب من Google Analytics Data API إلى خادم الردّ التلقائي على الويب عند تعديل المورد.

تحتوي إعدادات الإشعارات على قيم خاصة ولا تظهر إلا لمشروع Google Cloud Platform (GCP). قد تُرفِق مشاريع Google Cloud Platform المختلفة إشعارات الرد التلقائي على الويب المختلفة بمورد العمليات نفسه لفترة طويلة.

تمثيل 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، يتيح لك ذلك ضبط الوظيفة لطلب المصادقة. في Cloud IAM، ستحتاج إلى منح أذونات حساب الخدمة لدورَي Cloud Run Invoker (roles/run.invoker) وCloud Functions Invoker (roles/cloudfunctions.invoker) في طلب ما بعد الرد التلقائي على الويب لاجتياز مصادقة دوال Google Cloud. يمكن لواجهة برمجة التطبيقات هذه إرسال إشعارات الرد التلقائي على الويب إلى معرّفات URI عشوائية، وبالنسبة إلى خوادم الرد التلقائي على الويب بخلاف دوال Google Cloud، يجب تجاهل الرمز المميز لرقم التعريف هذا في عنوان حامل التفويض إذا لم يكن مطلوبًا.
channelToken

string

اختياريّ. الرمز المميز للقناة هو قيمة سلسلة عشوائية ويجب أن يبلغ الحد الأقصى لطول السلسلة 64 حرفًا. تسمح لك الرموز المميّزة للقناة بإثبات صحة مصدر إشعار الرد التلقائي على الويب. وهذا يحمي من انتحال الرسالة. سيتم تحديد الرمز المميز للقناة في عنوان HTTP X-Goog-Channel-Token لطلب الرد التلقائي على الويب POST.

لا حاجة إلى رمز مميّز للقناة لاستخدام إشعارات الرد التلقائي على الويب.