تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Acl: watch

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

الطلب

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، بالمللي ثانية اختياريّ.