تعديل تقويم حالي في قائمة التقاويم الخاصة بالمستخدم تتيح هذه الطريقة بنية التصحيح. يُرجى العلم أنّ كل طلب تصحيح يستهلك ثلاث وحدات حصة، لذا ننصحك باستخدام 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 |
https://www.googleapis.com/auth/calendar.app.created |
https://www.googleapis.com/auth/calendar.calendarlist |
لمزيد من المعلومات، يُرجى الاطّلاع على صفحة المصادقة والتفويض.
نص الطلب
في نص الطلب، قدِّم الأجزاء ذات الصلة من مورد CalendarList، وفقًا لقواعد دلالات التصحيح.
الردّ
في حال نجاح هذه الطريقة، تُرجع مورد CalendarList في نص الاستجابة.
جرّب الآن
استخدِم "مستكشف واجهات برمجة التطبيقات" أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الاستجابة.