Acl: watch

ملاحظة: يتطلب هذا الإجراء تفويضًا.

انتبِه إلى التغييرات في موارد قائمة التحكّم بالوصول.

الطلب

طلب HTTP

POST https://www.googleapis.com/calendar/v3/calendars/calendarId/acl/watch

المعلمات

اسم المعلَمة	القيمة	الوصف
مَعلمات المسار
calendarId	string	معرّف التقويم لاسترداد أرقام تعريف التقاويم، يمكنك استدعاء الطريقة calendarList.list. إذا كنت تريد الوصول إلى التقويم الأساسي للمستخدم الذي سجّل الدخول حاليًا، استخدِم الكلمة الرئيسية "primary".

التفويض

يتطلب هذا الطلب تفويضًا بنطاق واحد على الأقل من النطاقات التالية:

النطاق
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.acls
https://www.googleapis.com/auth/calendar.acls.readonly

لمزيد من المعلومات، يُرجى الاطّلاع على صفحة المصادقة والتفويض.

نص الطلب

في نص الطلب، قدِّم البيانات بالبنية التالية:

{
  "id": string,
  "token": string,
  "type": string,
  "address": string,
  "params": {
    "ttl": string
  }
}

اسم السمة	القيمة	الوصف	ملاحظات
id	string	معرّف UUID أو سلسلة فريدة مشابهة تُحدِّد هذه القناة.
token	string	سلسلة عشوائية يتم إرسالها إلى العنوان المستهدَف مع كل إشعار يتم إرساله عبر هذه القناة. اختياريّ.
type	string	نوع آلية الإرسال المستخدَمة لهذه القناة. القيم الصالحة هي "web_hook" (أو "webhook"). تشير كلتا القيمتَين إلى قناة يتم فيها استخدام طلبات Http لإرسال الرسائل.
address	string	العنوان الذي يتم إرسال الإشعارات إليه لهذه القناة.
params	object	مَعلمات إضافية تتحكّم في سلوك قناة الإرسال اختياريّ.
params.ttl	string	الوقت الذي تبقى فيه قناة الإشعارات صالحة بالثواني القيمة التلقائية هي 604800 ثانية.

الردّ

إذا كانت الاستجابة ناجحة، تعرض هذه الطريقة نص استجابة بالبنية التالية:

{
  "kind": "api#channel",
  "id": string,
  "resourceId": string,
  "resourceUri": string,
  "token": string,
  "expiration": long
}

اسم السمة	القيمة	الوصف	ملاحظات
kind	string	يحدِّد هذا الحقل القناة كقناة إشعارات تُستخدَم للتتبّع عن التغييرات في المورد "api#channel".
id	string	معرّف UUID أو سلسلة فريدة مشابهة تُحدِّد هذه القناة.
resourceId	string	معرّف غير شفاف يحدّد المورد الذي تتم مشاهدته على هذه القناة. أن تكون مستقرة على مستوى إصدارات واجهة برمجة التطبيقات المختلفة
resourceUri	string	معرّف خاص بالإصدار للمورد الذي تتم مشاهدته
token	string	سلسلة عشوائية يتم إرسالها إلى العنوان المستهدَف مع كل إشعار يتم إرساله عبر هذه القناة. اختياريّ.
expiration	long	تاريخ ووقت انتهاء صلاحية قناة الإشعارات، مُعبَّرًا عنه كطابع زمني لنظام التشغيل UNIX، بالمللي ثانية اختياريّ.