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