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

API Reference

يتم تنظيم مرجع واجهة برمجة التطبيقات هذا حسب نوع المورد. يحتوي كل نوع من أنواع الموارد على تمثيل بيانات واحد أو أكثر وطريقة واحدة أو أكثر.

أنواع الموارد

قائمة التحكم في الوصول (Acl)
CalendarList
التقاويم
القنوات
الألوان
الأحداث
متوفّر مشغول
الإعدادات

Acl

للحصول على تفاصيل موارد Acl، يُرجى الاطّلاع على صفحة تمثيل الموارد.

الطريقة	طلب HTTP	الوصف
معرّفات الموارد المنتظمة (URI) المرتبطة بـ https://www.googleapis.com/calendar/v3، ما لم يُذكر خلاف ذلك
حذف	`DELETE /calendars/calendarId/acl/ruleId`	حذف قاعدة تحكُّم بالوصول.
الحصول على	`GET /calendars/calendarId/acl/ruleId`	تعرض قاعدة تحكُّم بالوصول.
إدراج	`POST /calendars/calendarId/acl`	ينشئ قاعدة تحكُّم بالوصول.
list	`GET /calendars/calendarId/acl`	عرض القواعد في قائمة التحكم بالوصول إلى التقويم.
تصحيح	`PATCH /calendars/calendarId/acl/ruleId`	لتعديل قاعدة تحكُّم بالوصول. تدعم هذه الطريقة دلالات التصحيح. تجدر الإشارة إلى أنّ كل طلب تصحيح يستهلك ثلاث وحدات حصة، ويفضّل استخدام `get` متبوعًا بـ `update`. تحلّ قيم الحقول التي تحدّدها محلّ القيم الحالية. تبقى الحقول التي لا تحدِّدها في الطلب بدون تغيير. تستبدل حقول الصفيف، إذا تم تحديدها، الصفائف الحالية، مما يؤدي إلى تجاهل أي عناصر صفيف سابقة.
تعديل	`PUT /calendars/calendarId/acl/ruleId`	لتعديل قاعدة تحكُّم بالوصول.
ساعة	`POST /calendars/calendarId/acl/watch`	راقب التغييرات التي تطرأ على موارد قائمة التحكم بالوصول (ACL).

CalendarList

بالنسبة إلى تفاصيل موارد CalendarList، يُرجى الاطّلاع على صفحة تمثيل الموارد.

الطريقة	طلب HTTP	الوصف
معرّفات الموارد المنتظمة (URI) المرتبطة بـ https://www.googleapis.com/calendar/v3، ما لم يُذكر خلاف ذلك
حذف	`DELETE /users/me/calendarList/calendarId`	إزالة تقويم من قائمة التقاويم لدى المستخدم
الحصول على	`GET /users/me/calendarList/calendarId`	لعرض تقويم من قائمة تقويم المستخدم.
إدراج	`POST /users/me/calendarList`	لإدراج تقويم حالي في قائمة تقاويم المستخدم.
list	`GET /users/me/calendarList`	عرض التقاويم في قائمة تقاويم المستخدم
تصحيح	`PATCH /users/me/calendarList/calendarId`	تعديل تقويم حالي في قائمة تقاويم المستخدم تدعم هذه الطريقة دلالات التصحيح. تجدر الإشارة إلى أنّ كل طلب تصحيح يستهلك ثلاث وحدات حصة، ويفضّل استخدام `get` متبوعًا بـ `update`. تحلّ قيم الحقول التي تحدّدها محلّ القيم الحالية. تبقى الحقول التي لا تحدِّدها في الطلب بدون تغيير. تستبدل حقول الصفيف، إذا تم تحديدها، الصفائف الحالية، مما يؤدي إلى تجاهل أي عناصر صفيف سابقة.
تعديل	`PUT /users/me/calendarList/calendarId`	تعديل تقويم حالي في قائمة تقاويم المستخدم
ساعة	`POST /users/me/calendarList/watch`	ترقُّب التغييرات التي يتم إجراؤها على موارد CalendarList.

خدمات طباعة التقويم

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

الطريقة	طلب HTTP	الوصف
معرّفات الموارد المنتظمة (URI) المرتبطة بـ https://www.googleapis.com/calendar/v3، ما لم يُذكر خلاف ذلك
محو	`POST /calendars/calendarId/clear`	يؤدي إلى محو تقويم أساسي. تؤدي هذه العملية إلى حذف جميع الأحداث المرتبطة بالتقويم الأساسي لحساب معيّن.
حذف	`DELETE /calendars/calendarId`	حذف تقويم ثانوي. استخدِم calendar.clear لمحو جميع الأحداث في التقاويم الأساسية.
الحصول على	`GET /calendars/calendarId`	تعرض البيانات الوصفية لتقويم.
إدراج	`POST /calendars`	إنشاء تقويم ثانوي.
تصحيح	`PATCH /calendars/calendarId`	لتعديل البيانات الوصفية لتقويم تدعم هذه الطريقة دلالات التصحيح. تجدر الإشارة إلى أنّ كل طلب تصحيح يستهلك ثلاث وحدات حصة، ويفضّل استخدام `get` متبوعًا بـ `update`. تحلّ قيم الحقول التي تحدّدها محلّ القيم الحالية. تبقى الحقول التي لا تحدِّدها في الطلب بدون تغيير. تستبدل حقول الصفيف، إذا تم تحديدها، الصفائف الحالية، مما يؤدي إلى تجاهل أي عناصر صفيف سابقة.
تعديل	`PUT /calendars/calendarId`	لتعديل البيانات الوصفية لتقويم

القنوات

بالنسبة إلى تفاصيل موارد القنوات، يُرجى الاطّلاع على صفحة تمثيل الموارد.

الطريقة	طلب HTTP	الوصف
معرّفات الموارد المنتظمة (URI) المرتبطة بـ https://www.googleapis.com/calendar/v3، ما لم يُذكر خلاف ذلك
إيقاف	`POST /channels/stop`	التوقّف عن مشاهدة المراجع من خلال هذه القناة

ألوان

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

الطريقة	طلب HTTP	الوصف
معرّفات الموارد المنتظمة (URI) المرتبطة بـ https://www.googleapis.com/calendar/v3، ما لم يُذكر خلاف ذلك
الحصول على	`GET /colors`	عرض تعريفات الألوان للتقاويم والأحداث

فعاليات

بالنسبة إلى تفاصيل موارد الأحداث، يُرجى الاطّلاع على صفحة تمثيل الموارد.

الطريقة	طلب HTTP	الوصف
معرّفات الموارد المنتظمة (URI) المرتبطة بـ https://www.googleapis.com/calendar/v3، ما لم يُذكر خلاف ذلك
حذف	`DELETE /calendars/calendarId/events/eventId`	لحذف حدث
الحصول على	`GET /calendars/calendarId/events/eventId`	لعرض حدث استنادًا إلى معرّف "تقويم Google" الخاص به. لاسترداد حدث باستخدام معرّف iالتقويم، يمكنك استدعاء طريقةevents.list باستخدام مَعلمة `iCalUID`.
import	`POST /calendars/calendarId/events/import`	لاستيراد حدث. تُستخدم هذه العملية لإضافة نسخة خاصة من حدث حالي إلى تقويم. لا يمكن استيراد سوى الأحداث التي تحتوي على `eventType` من `default`. السلوك المتوقّف نهائيًا: إذا تم استيراد حدث ليس "`default`"، سيتم تغيير نوعه إلى "`default`" وسيتم استبعاد أي خصائص من نوع الحدث قد تكون مدرَجة.
إدراج	`POST /calendars/calendarId/events`	لإنشاء حدث.
المثيلات	`GET /calendars/calendarId/events/eventId/instances`	تعرِض هذه السمة مثيلاً من الحدث المتكرّر المحدَّد.
list	`GET /calendars/calendarId/events`	عرض الأحداث في التقويم المحدّد.
نقل	`POST /calendars/calendarId/events/eventId/move`	نقل حدث إلى تقويم آخر، أي تغيير منظِّم الحدث تجدر الإشارة إلى أنّه لا يمكن نقل سوى `default` حدث، أي أنّه لا يمكن نقل أحداث `outOfOffice` و`focusTime` و`workingLocation`. مَعلمات طلب البحث المطلوبة: `destination`
تصحيح	`PATCH /calendars/calendarId/events/eventId`	لتعديل حدث تدعم هذه الطريقة دلالات التصحيح. تجدر الإشارة إلى أنّ كل طلب تصحيح يستهلك ثلاث وحدات حصة، ويفضّل استخدام `get` متبوعًا بـ `update`. تحلّ قيم الحقول التي تحدّدها محلّ القيم الحالية. تبقى الحقول التي لا تحدِّدها في الطلب بدون تغيير. تستبدل حقول الصفيف، إذا تم تحديدها، الصفائف الحالية، مما يؤدي إلى تجاهل أي عناصر صفيف سابقة.
quickAdd	`POST /calendars/calendarId/events/quickAdd`	تنشئ حدثًا استنادًا إلى سلسلة نصية بسيطة. مَعلمات طلب البحث المطلوبة: `text`
تعديل	`PUT /calendars/calendarId/events/eventId`	لتعديل حدث لا تتيح هذه الطريقة دلالات التصحيح وتعمل دائمًا على تحديث مورد الحدث بالكامل. لإجراء تعديل جزئي، عليك تنفيذ عملية `get` متبوعة بالرمز `update` باستخدام علامات etag لضمان تقسيم قيم الذرة.
ساعة	`POST /calendars/calendarId/events/watch`	ترقُّب التغييرات في موارد الأحداث.

متوفّر

لمعرفة تفاصيل مورد "متوفّر مشغول"، يُرجى الاطّلاع على صفحة تمثيل الموارد.

الطريقة	طلب HTTP	الوصف
معرّفات الموارد المنتظمة (URI) المرتبطة بـ https://www.googleapis.com/calendar/v3، ما لم يُذكر خلاف ذلك
طلب البحث	`POST /freeBusy`	لعرض معلومات الحالة متوفّر/مشغول لمجموعة من التقاويم.

الإعدادات

لمعرفة تفاصيل مورد الإعدادات، يُرجى الاطّلاع على صفحة تمثيل الموارد.

الطريقة	طلب HTTP	الوصف
معرّفات الموارد المنتظمة (URI) المرتبطة بـ https://www.googleapis.com/calendar/v3، ما لم يُذكر خلاف ذلك
الحصول على	`GET /users/me/settings/setting`	تعرِض هذه السمة إعداد مستخدم واحد.
list	`GET /users/me/settings`	عرض جميع إعدادات المستخدم للمستخدم الذي تمت المصادقة عليه.
ساعة	`POST /users/me/settings/watch`	يمكنك ملاحظة التغييرات التي تطرأ على موارد الإعدادات.