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