نظرة عامة على Google Calendar API
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
واجهة برمجة تطبيقات "تقويم Google" هي واجهة برمجة تطبيقات RESTful يمكن الوصول إليها من خلال طلبات HTTP صريحة أو باستخدام Google Client Libraries. تعرض واجهة برمجة التطبيقات معظم الميزات المتاحة في واجهة الويب الخاصة بـ "تقويم Google".
في ما يلي قائمة بالمصطلحات الشائعة المستخدَمة في Google Calendar API:
- الحدث
- حدث في تقويم يتضمّن معلومات مثل العنوان ووقتَي البدء والانتهاء والضيوف يمكن أن تكون الأحداث أحداثًا فردية أو أحداثًا متكرّرة. يتم تمثيل الحدث من خلال مورد الحدث.
- تقويم Google
- مجموعة من الأحداث يتضمّن كل تقويم بيانات وصفية مرتبطة به، مثل وصف التقويم أو المنطقة الزمنية التلقائية للتقويم. يتم تمثيل البيانات الوصفية لتقويم واحد من خلال مورد تقويم.
- قائمة التقويم
- قائمة بجميع التقاويم في قائمة تقاويم المستخدم ضمن واجهة مستخدم "تقويم Google" يتم تمثيل البيانات الوصفية لتقويم واحد يظهر في قائمة التقويمات باستخدام مورد CalendarListEntry.
تتضمّن هذه البيانات الوصفية خصائص خاصة بالمستخدم في التقويم، مثل لونه أو الإشعارات الخاصة بالأحداث الجديدة.
- الإعداد
- إعدادات مفضّلة للمستخدم من واجهة مستخدم "تقويم Google"، مثل المنطقة الزمنية للمستخدم يتم تمثيل إعدادات المستخدم المفضَّلة من خلال
مورد إعدادات.
- ACL
- قاعدة للتحكّم في الوصول تمنح مستخدمًا (أو مجموعة من المستخدمين) مستوى محدّدًا من إذن الوصول إلى تقويم. يتم تمثيل قاعدة تحكّم واحدة في الوصول من خلال مصدر ACL.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Google Calendar API overview\n\nThe Google Calendar API is a RESTful API that can be accessed through explicit HTTP\ncalls or using the Google Client Libraries. The API exposes most of the features\navailable in the Google Calendar Web interface.\n\nFollowing is a list of common terms used in the Google Calendar API:\n\n*[Event](/workspace/calendar/v3/reference/events)*\n: An event on a calendar containing information such as the title, start and end\n times, and attendees. Events can be either single events or [recurring\n events](/workspace/calendar/concepts/events-calendars#recurring_events). An event is\n represented by an\n [Event resource](/workspace/calendar/v3/reference/events#resource-representations).\n\n*[Calendar](/workspace/calendar/v3/reference/calendars)*\n: A collection of events. Each calendar has associated metadata, such as\n calendar description or default calendar time zone. The metadata for a single\n calendar is represented by a\n [Calendar resource](/workspace/calendar/v3/reference/calendars).\n\n*[Calendar List](/workspace/calendar/v3/reference/calendarList)*\n: A list of all calendars on a user's calendar list in the Calendar UI. The\n metadata for a single calendar that appears on the calendar list is represented\n by a\n [CalendarListEntry resource](/workspace/calendar/v3/reference/calendarList).\n This metadata includes user-specific properties of the calendar, such\n as its color or notifications for new events.\n\n*[Setting](/workspace/calendar/v3/reference/settings)*\n: A user preference from the Calendar UI, such as the user's\n time zone. A single user preference is represented by a\n [Setting Resource](/workspace/calendar/v3/reference/settings).\n\n*[ACL](/workspace/calendar/v3/reference/acl)*\n: An access control rule granting a user (or a group of users) a specified level\n of access to a calendar. A single access control rule is represented by an [ACL\n resource](/workspace/calendar/v3/reference/acl).\n\nRelated topics\n--------------\n\n- To learn about developing with Google Workspace APIs, including handling\n authentication and authorization, refer\n to\n [Get started as a Google Workspace developer](/workspace/guides/getstarted-overview).\n\n- To learn how to configure and run a simple Google Calendar API app, read the\n [Quickstarts overview](/workspace/calendar/quickstarts-overview).\n\n|---|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| | Want to see the Google Calendar API in action? The Google Workspace Developers channel offers videos about tips, tricks, and the latest features. [Subscribe now](https://www.youtube.com/channel/UCUcg6az6etU_gRtZVAhBXaw) |"]]
