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