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

Events: watch

راقب التغييرات التي تطرأ على موارد الأحداث.

الطلب

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

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

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

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

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

في نص الطلب، يمكنك توفير البيانات بالبنية التالية:

{
  "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`	مدة البقاء بالثواني لقناة الإشعارات. والقيمة التلقائية هي 604,800 ثانية.

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

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