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