Calendars: update

تعديل البيانات الوصفية لتقويم جرّب الميزة الآن.

طلب

طلب 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".) اختياريّ. قابل للكتابة
workingHours object تمثّل هذه السمة المعلومات حول ساعات عمل المستخدم. تتوفّر هذه الميزة للتقاويم الأساسية لمستخدمي Google Workspace فقط. لتعديل ساعات العمل، يجب تمرير عنصر ساعات العمل بالكامل. في حال عدم تحديد ساعات العمل (أو تمريرها كقيمة فارغة أو كائن فارغ)، تبقى ساعات العمل الحالية بدون تغيير. لإيقاف ساعات العمل أو محو الجدول الزمني، اضبط workingHoursEnabled على "خطأ" (واحذف availableTimes أو مرِّر قائمة فارغة). قابل للكتابة
workingHours.availableTimes[] list ساعات العمل وتمثّل كل فترة توفّر مجموعة ساعات عمل المستخدم خلال يوم واحد. قابل للكتابة
workingHours.availableTimes[].dayOfWeek string يوم من الأسبوع الحقل مطلوب. القيم المحتمَلة هي:
  • "monday"
  • "tuesday"
  • "wednesday"
  • "thursday"
  • "friday"
  • "saturday"
  • "sunday"
قابل للكتابة
workingHours.availableTimes[].periodEnd integer نهاية الفترة، بالدقائق من بداية اليوم، غير شاملة الحقل مطلوب. قابل للكتابة
workingHours.availableTimes[].periodStart integer بداية الفترة، بالدقائق من بداية اليوم، شاملة الحقل مطلوب. قابل للكتابة
workingHours.workingHoursEnabled boolean ما إذا كانت ساعات العمل مفعَّلة لهذا التقويم لا يمكن ضبط القيمة على "صحيح" عندما يكون حقل "availableTimes" فارغًا. قابل للكتابة

الردّ

في حال نجاح هذه الطريقة، ستعرض مورد تقاويم في نص الاستجابة.

جرِّبها الآن.

يمكنك استخدام "مستكشف واجهات برمجة التطبيقات" أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الاستجابة.