Calendars

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

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

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

{
  "kind": "calendar#calendar",
  "etag": etag,
  "id": string,
  "summary": string,
  "description": string,
  "location": string,
  "timeZone": string,
  "dataOwner": string,
  "conferenceProperties": {
    "allowedConferenceSolutionTypes": [
      string
    ]
  },
  "labelProperties": {
    "eventLabels": [
      {
        "id": string,
        "backgroundColor": string,
        "name": string
      }
    ]
  },
  "autoAcceptInvitations": boolean
}

الطُرق

محو

يمحو تقويمًا أساسيًا. تؤدي هذه العملية إلى حذف جميع الأحداث المرتبطة بالتقويم الأساسي لأحد الحسابات.

حذف

لحذف تقويم ثانوي استخدِم calendars.clear لمحو جميع الأحداث في التقاويم الأساسية.

الحصول على

تعرض هذه الطريقة البيانات الوصفية الخاصة بتقويم.

إدراج

تنشئ هذه الطريقة تقويمًا ثانويًا.

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

patch

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

transferOwnership

تنقل هذه الطريقة تقويمًا ثانويًا بين المستخدمين داخل مؤسسة Google Workspace. يتطلب مصادقة المستخدم من خلال امتياز مشرف إدارة التقاويم، وأحد نطاقات التفويض التالية:

• https://www.googleapis.com/auth/calendar
• https://www.googleapis.com/auth/calendar.calendars

في الطلب، اضبط قيمة useAdminAccess على true. يجب أن يكون التقويم الثانوي نشطًا ليتم نقله. لا يمكن نقل التقاويم التي تم إيقافها أو حذفها.

تعديل

تعديل البيانات الوصفية لتقويم