تتيح لك خدمة التقويم المتقدمة استخدام واجهة برمجة تطبيقات تقويم Google العامة في برمجة التطبيقات. وتمامًا مثل خدمة التقويم المضمَّنة في Apps Script، تتيح واجهة برمجة التطبيقات هذه للنصوص البرمجية الوصول إلى تقويم Google التابع للمستخدم وتعديله، بما في ذلك التقاويم الإضافية التي اشترك بها المستخدم. في معظم الحالات، تكون الخدمة المضمّنة أسهل في الاستخدام، ولكن تقدم هذه الخدمة المتقدمة بعض الميزات الإضافية، بما في ذلك تعيين لون الخلفية للأحداث الفردية.
مَراجع
للحصول على معلومات تفصيلية حول هذه الخدمة، اطّلع على المستندات المرجعية لواجهة برمجة التطبيقات العامة لتقويم Google. مثل جميع الخدمات المتقدمة في "برمجة التطبيقات"، تستخدم خدمة "التقويم" المتقدمة العناصر والطرق والمعايير نفسها التي تستخدمها واجهة برمجة التطبيقات العامة. لمزيد من المعلومات، راجع كيفية تحديد توقيعات الطريقة.
للإبلاغ عن مشكلات والعثور على دعم آخر، راجع دليل دعم التقويم.
رؤوس طلبات HTTP
يمكن لخدمة "تقويم Google" المتقدمة قبول عنوانَي طلب HTTP
If-Match
وIf-None-Match
. للحصول على التفاصيل، اطلع على
الوثائق المرجعية.
نموذج التعليمات البرمجية
يستخدم نموذج الشفرة التالي الإصدار 3 من API.
إنشاء الأحداث
يوضح المثال التالي كيفية إنشاء حدث في التقويم الافتراضي للمستخدم.
إدراج التقاويم
يوضح المثال التالي كيفية استرداد التفاصيل حول التقاويم التي تظهر في قائمة تقاويم المستخدم.
أحداث القائمة
يوضح المثال التالي كيفية إدراج الأحداث الـ 10 القادمة في التقويم الافتراضي للمستخدم.
تعديل حدث بشروط
يوضّح المثال التالي كيفية تحديث حدث "تقويم Google" بشروط باستخدام الرأس If-Match
. ينشئ النص البرمجي حدثًا جديدًا، وينتظر 30 ثانية، ثم يحدّث الحدث فقط إذا لم يتم تغيير تفاصيل الحدث منذ إنشاء الحدث.
استرداد حدث بشروط
يوضّح المثال التالي كيفية جلب حدث "تقويم Google" بشروط باستخدام الرأس If-None-Match
. ينشئ النص البرمجي حدثًا جديدًا، ثم يفحص الحدث للتغييرات لمدة 30 ثانية. في أي وقت يتم فيه تغيير الحدث، يتم جلب
الإصدار الجديد.
مزامنة الأحداث
يوضح المثال التالي كيفية استرداد الأحداث باستخدام الرموز المميزة للمزامنة. عند تضمين الرمز المميز للمزامنة في طلب خدمة متقدمة للتقويم، فإن الاستجابة الناتجة لا تتضمن سوى العناصر التي تم تغييرها منذ إنشاء هذا الرمز المميز، مما يتيح معالجة أكثر فعالية. راجع مزامنة الموارد بكفاءة للحصول على مزيد من التفاصيل حول عملية المزامنة.
يستخدم المثال التالي طريقة getRelativeDate(daysOffset, hour)
المحدّدة في الأمثلة أعلاه.