Calendars

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

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

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

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

القيم المحتملة هي:

  • "eventHangout"
  • "eventNamedHangout"
  • "hangoutsMeet"
اختياري.
dataOwner string عنوان البريد الإلكتروني لمالك التقويم يتم ضبط هذا الخيار للتقاويم الثانوية فقط. للقراءة فقط.
description string وصف التقويم اختيارية: قابل للكتابة
etag etag تمثّل هذه السمة علامة ETag الخاصة بالمرجع.
id string معرّف التقويم لاسترداد المعرّفات، استخدِم طريقة calendarList.list().
kind string نوع المورد ("calendar#calendar")
location string الموقع الجغرافي للتقويم كنص حر اختيارية: قابل للكتابة
summary string عنوان التقويم قابل للكتابة
timeZone string المنطقة الزمنية للتقويم (يتم تنسيقه كاسم في "قاعدة بيانات المناطق الزمنية IANA"، مثلاً "Europe/Zurich"). اختيارية: قابل للكتابة

الطُرق

محو
يمحو تقويمًا أساسيًا. تؤدي هذه العملية إلى حذف جميع الأحداث المرتبطة بالتقويم الأساسي لأحد الحسابات.
حذف
يحذف تقويمًا ثانويًا. استخدِم calendars.clear لمحو جميع الأحداث في التقاويم الأساسية.
الحصول على
تعرض هذه الطريقة البيانات الوصفية الخاصة بتقويم.
إدراج
تنشئ هذه الطريقة تقويمًا ثانويًا.

يصبح المستخدم الذي تمّت المصادقة عليه في الطلب هو مالك البيانات في التقويم الجديد.

patch
تعديل البيانات الوصفية لتقويم تتيح هذه الطريقة استخدام دلالات التصحيح. يُرجى العِلم أنّ كل طلب تصحيح يستهلك ثلاث وحدات حصة، لذا يُفضّل استخدام get متبوعًا بـ update. تحلّ قيم الحقول التي تحدّدها محلّ القيم الحالية. تبقى الحقول التي لم تحدّدها في الطلب بدون تغيير. إذا تم تحديد حقول المصفوفة، سيتم استبدال المصفوفات الحالية، ما يؤدي إلى تجاهل أي عناصر مصفوفة سابقة.
تعديل
تعديل البيانات الوصفية لتقويم