Calendars

مجموعة من كل التقاويم الحالية راجِع أيضًا التقاويم في مقابل قائمة CalendarList.

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

تمثيلات الموارد

{
  "kind": "calendar#calendar",
  "etag": etag,
  "id": string,
  "summary": string,
  "description": string,
  "location": string,
  "timeZone": string,
  "conferenceProperties": {
    "allowedConferenceSolutionTypes": [
      string
    ]
  }
}
اسم الموقع القيمة الوصف Notes
conferenceProperties nested object خصائص مكالمات الفيديو لهذا التقويم، على سبيل المثال، أنواع المؤتمرات المسموح بها
conferenceProperties.allowedConferenceSolutionTypes[] list أنواع حلول مكالمات الفيديو المتاحة لهذا التقويم.

في ما يلي القيم المحتمَلة:

  • "eventHangout"
  • "eventNamedHangout"
  • "hangoutsMeet"
اختيارية.

description string وصف التقويم. اختياريّ. قابل للكتابة
etag etag علامة ETag للمورد.
id string معرّف التقويم. لاسترداد المعرفات، استدعِ الطريقة calendarList.list().
kind string نوع المورد ("calendar#calendar").
location string الموقع الجغرافي للتقويم كنص مرن. اختياريّ. قابل للكتابة
summary string عنوان التقويم. قابل للكتابة
timeZone string المنطقة الزمنية للتقويم. (بتنسيق اسم قاعدة بيانات المناطق الزمنية الصادرة عن منظمة IANA (المنظمة المعنية بأرقام الإنترنت المخصصة)، على سبيل المثال "أوروبا/زيورخ"). اختياريّ. قابل للكتابة

الطُرق

واضح
لمحو تقويم أساسي. تؤدي هذه العملية إلى حذف جميع الأحداث المرتبطة بالتقويم الأساسي للحساب.
حذف
حذف تقويم ثانوي. يمكنك استخدام calendar.clear لمحو جميع الأحداث في التقاويم الأساسية.
الحصول على
عرض البيانات الوصفية لتقويم.
إدراج
لإنشاء تقويم ثانوي.
حزمة
تعمل على تعديل البيانات الوصفية لتقويم. تدعم هذه الطريقة دلالات التصحيح. تجدر الإشارة إلى أنّ كل طلب تصحيح يستهلك ثلاث وحدات حصة، ويفضّل استخدام get متبوعة بعلامة update. تحلّ قيم الحقول التي تحدّدها محلّ القيم الحالية. تبقى الحقول التي لا تحدّدها في الطلب بدون تغيير. تؤدي حقول المصفوفة، في حال تحديدها، إلى استبدال الصفائف الحالية، ويؤدي هذا إلى إلغاء أي عناصر صفيف سابقة.
تعديل
تعمل على تعديل البيانات الوصفية لتقويم.