Calendars

مجموعه‌ای از تمام تقویم‌های موجود. همچنین به بخش 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 قالب‌بندی می‌شود، مثلاً "اروپا/زوریخ".) اختیاری. قابل نوشتن

روش‌ها

واضح
یک تقویم اصلی را پاک می‌کند. این عملیات تمام رویدادهای مرتبط با تقویم اصلی یک حساب را حذف می‌کند.
حذف
یک تقویم ثانویه را حذف می‌کند. برای پاک کردن همه رویدادهای تقویم‌های اصلی از calendars.clear استفاده کنید.
دریافت
متادیتای یک تقویم را برمی‌گرداند.
درج
یک تقویم ثانویه ایجاد می‌کند.

کاربر احراز هویت شده برای درخواست، مالک داده‌های تقویم جدید می‌شود.

پچ
فراداده‌های یک تقویم را به‌روزرسانی می‌کند. این روش از معنای وصله پشتیبانی می‌کند. توجه داشته باشید که هر درخواست وصله سه واحد سهمیه مصرف می‌کند؛ بهتر است از get و به دنبال آن update استفاده کنید. مقادیر فیلدی که مشخص می‌کنید جایگزین مقادیر موجود می‌شوند. فیلدهایی که در درخواست مشخص نمی‌کنید بدون تغییر باقی می‌مانند. فیلدهای آرایه، در صورت مشخص شدن، آرایه‌های موجود را بازنویسی می‌کنند. این کار عناصر آرایه قبلی را حذف می‌کند.
به‌روزرسانی
فراداده‌های یک تقویم را به‌روزرسانی می‌کند.