تعديل تقويم حالي في قائمة التقويم الخاصة بالمستخدم تدعم هذه الطريقة دلالات التصحيح. تجدر الإشارة إلى أنّ كل طلب تصحيح يستهلك ثلاث وحدات حصة، ويفضّل استخدام get
متبوعة بعلامة update
. تحلّ قيم الحقول التي تحدّدها محلّ القيم الحالية. تبقى الحقول التي لا تحدّدها في الطلب بدون تغيير. تؤدي حقول المصفوفة، في حال تحديدها، إلى استبدال الصفائف الحالية، ويؤدي هذا إلى إلغاء أي عناصر صفيف سابقة.
تجربة ذلك الآن
الطلب
طلب HTTP
PATCH https://www.googleapis.com/calendar/v3/users/me/calendarList/calendarId
المَعلمات
اسم المعلَمة | القيمة | الوصف |
---|---|---|
مَعلمات المسار | ||
calendarId |
string |
معرِّف التقويم. لاسترداد معرّفات التقويم، يمكنك استدعاء الطريقة calendarList.list. إذا كنت تريد الوصول إلى التقويم الأساسي للمستخدم المسجّل دخوله حاليًا، استخدِم الكلمة الرئيسية "primary ".
|
مَعلمات طلب البحث الاختيارية | ||
colorRgbFormat |
boolean |
يمكنك اختيار ما إذا كنت تريد استخدام الحقلين foregroundColor وbackgroundColor لكتابة ألوان التقويم (RGB). في حال استخدام هذه الميزة، سيتم تلقائيًا ضبط حقل colorId المستند إلى الفهرس على خيار المطابقة الأفضل. اختياريّ. القيمة التلقائية هي False.
|
التفويض
يتطلب هذا الطلب تفويضًا بالنطاق التالي:
النطاق |
---|
https://www.googleapis.com/auth/calendar |
للحصول على مزيد من المعلومات، يُرجى الاطّلاع على صفحة المصادقة والتفويض.
نص الطلب
في نص الطلب، قدم الأجزاء ذات الصلة من مورد CalendarList، وفقًا لقواعد دلالات التصحيح.
الإجابة
وفي حال نجاحها، تعرِض هذه الطريقة مورد CalendarList في نص الاستجابة.
تجربة
يمكنك استخدام مستكشف واجهات برمجة التطبيقات أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الاستجابة.