تعدّل هذه الطريقة البيانات الوصفية لتقويم. جرِّبها الآن.
طلب
طلب HTTP
PUT https://www.googleapis.com/calendar/v3/calendars/calendarIdالمعلمات
| اسم المعلَمة | القيمة | الوصف |
|---|---|---|
| مَعلمات المسار | ||
calendarId |
string |
معرّف التقويم لاسترداد أرقام تعريف التقويم، استخدِم طريقة calendarList.list. إذا أردت الوصول إلى التقويم الأساسي للمستخدم الذي سجّل الدخول حاليًا، استخدِم الكلمة الرئيسية "primary".
|
التفويض
يتطلّب هذا الطلب الحصول على تفويض باستخدام نطاق واحد على الأقل من النطاقات التالية:
| النطاق |
|---|
https://www.googleapis.com/auth/calendar |
https://www.googleapis.com/auth/calendar.app.created |
https://www.googleapis.com/auth/calendar.calendars |
لمزيد من المعلومات، يُرجى الاطّلاع على صفحة المصادقة والتفويض.
نص الطلب
في نص الطلب، قدِّم مورد تقاويم مع السمات التالية:
| اسم السمة | القيمة | الوصف | ملاحظات |
|---|---|---|---|
| السمات الاختيارية | |||
description |
string |
وصف التقويم اختياريّ. | قابل للكتابة |
labelProperties |
nested object |
سمات التصنيفات المحدّدة في هذا التقويم في حال تحديدها، سيتم استبدال خصائص التصنيف الحالية. في حال عدم تحديدها، ستبقى خصائص التصنيف بدون تغيير. | قابل للكتابة |
labelProperties.eventLabels[] |
list |
تصنيفات الأحداث المحدّدة في هذا التقويم إذا كان هذا الحقل متوفّرًا عند تعديل التقويم، سيتم استبدال تصنيفات الأحداث الحالية به. وسِّع القائمة لإضافة تصنيف جديد للأحداث، وأزِل الكيانات من القائمة لحذف تصنيف من التقويم. يمكن أن يحتوي كل تقويم على 200 تصنيف كحد أقصى. |
قابل للكتابة |
labelProperties.eventLabels[].backgroundColor |
string |
لون خلفية التصنيف بتنسيق سداسي عشري، مثل "#039be5" يتم عرض الأحداث التي تحمل هذا التصنيف بهذا اللون. الحقل مطلوب. |
قابل للكتابة |
labelProperties.eventLabels[].id |
string |
معرّف التصنيف اختياري عند إدراج تصنيف جديد في حال عدم توفيره، سيتم إنشاء معرّف فريد. مطلوب عند تعديل تصنيف. في حال توفّره، يجب أن يكون المعرّف فريدًا ضمن التقويم وأن يتّبع تنسيق UUID. |
قابل للكتابة |
labelProperties.eventLabels[].name |
string |
اسم التصنيف. اختياريّ. يجب ألا يزيد عدد الأحرف عن 50 حرفًا في حال توفُّرها. |
قابل للكتابة |
location |
string |
الموقع الجغرافي للتقويم كنص حر اختياريّ. | قابل للكتابة |
summary |
string |
عنوان التقويم | قابل للكتابة |
timeZone |
string |
المنطقة الزمنية للتقويم (يتم تنسيقه كاسم في "قاعدة بيانات المناطق الزمنية IANA"، مثلاً "Europe/Zurich"). اختياريّ. | قابل للكتابة |
الردّ
في حال نجاح العملية، يعرض هذا الإجراء مورد "تقاويم" في نص الاستجابة.
جرِّبها الآن.
استخدِم "مستكشف واجهات برمجة التطبيقات" أدناه لطلب هذه الطريقة من خلال البيانات المباشرة والاطّلاع على الردّ.