خلفية واجهة برمجة تطبيقات التقويم
مفاهيم التقويم
تم إنشاء "تقويم Google" استنادًا إلى عدة مفاهيم أساسية:
- حدث
- حدث واحد في تقويم يحتوي على معلومات، مثل عنوان الحدث ووقت البدء ووقت الانتهاء والضيوف.
- التقويم
- إدخال تقويم واحد يحتوي على بيانات وصفية للتقويم، مثل الوصف
- قائمة التقويم
- قائمة بجميع التقاويم في قائمة تقاويم المستخدم في واجهة مستخدم "تقويم Google".
- المكان
- خيار مفضّل للمستخدم من واجهة مستخدم "تقويم Google"، مثل المنطقة الزمنية للمستخدم
- ACL
- قاعدة واحدة للتحكّم في الوصول تحتوي على معلومات مثل نوع القاعدة ونطاقها
نموذج بيانات واجهة برمجة تطبيقات التقويم
المورد هو كيان بيانات فردي له معرّف فريد. تعمل واجهة برمجة التطبيقات Calendar API على خمسة أنواع من الموارد:
- مورد الحدث
- تمثل حدثًا واحدًا في التقويم.
- مورد التقاويم
- يمثِّل هذا العرض بيانات وصفية لتقويم فردي.
- مورد قائمة التقويم
- تمثّل البيانات الوصفية لتقويم فردي يظهر في قائمة تقويم المستخدم في واجهة المستخدم.
- مورد الإعدادات
- يمثِّل هذا الإعداد تفضيلاً واحدًا للمستخدم من واجهة مستخدم التقويم.
- مورد قائمة التحكم بالوصول (ACL)
- يمثل قائمة التحكم بالوصول.
يستند نموذج بيانات واجهة برمجة تطبيقات التقويم إلى مجموعات من الموارد، تُسمى المجموعات:
- مجموعة الأحداث
- تتألف من جميع موارد الأحداث ضمن مورد تقويم محدَّد.
- مجموعة CalendarList
- تتألف من جميع موارد قائمة التقويم لمستخدم معين.
- مجموعة الإعدادات
- تتألف من جميع موارد الإعدادات لمستخدم معين.
- مجموعة ACL
- تتكون من جميع موارد ACL المطبَّقة على تقويم محدَّد.