Calendars
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
بازنمایی منابع
{
"kind": "calendar#calendar",
"etag": etag,
"id": string,
"summary": string,
"description": string,
"location": string,
"timeZone": string,
"conferenceProperties": {
"allowedConferenceSolutionTypes": [
string
]
}
}
نام ملک | ارزش | توضیحات | یادداشت ها |
---|
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، به عنوان مثال "اروپا/زوریخ".) اختیاری است. | قابل نوشتن |
روش ها
- روشن
- یک تقویم اولیه را پاک می کند. این عملیات تمام رویدادهای مرتبط با تقویم اولیه یک حساب را حذف می کند.
- حذف کنید
- یک تقویم ثانویه را حذف می کند. از calendars.clear برای پاک کردن همه رویدادها در تقویمهای اصلی استفاده کنید.
- دریافت کنید
- متادیتا را برای یک تقویم برمی گرداند.
- درج کنید
- یک تقویم ثانویه ایجاد می کند.
- پچ
- متادیتا را برای یک تقویم به روز می کند. این روش از معنای پچ پشتیبانی می کند. توجه داشته باشید که هر درخواست پچ سه واحد سهمیه مصرف می کند. ترجیح می دهند از یک
get
و به دنبال آن یک update
استفاده کنند. مقادیر فیلدی که مشخص می کنید جایگزین مقادیر موجود می شوند. فیلدهایی که در درخواست مشخص نمی کنید بدون تغییر باقی می مانند. فیلدهای آرایه، در صورت مشخص شدن، آرایه های موجود را بازنویسی می کنند. این هر عنصر آرایه قبلی را کنار می گذارد. - به روز رسانی کنید
- متادیتا را برای یک تقویم به روز می کند.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Calendars\n\nA collection of all existing calendars. See also [Calendars vs CalendarList](/workspace/calendar/api/concepts/events-calendars#calendar_and_calendar_list).\n\nFor a list of [methods](#methods) for this resource, see the end of this page.\n\nResource representations\n------------------------\n\n\u003cbr /\u003e\n\n```text\n{\n \"kind\": \"calendar#calendar\",\n \"etag\": etag,\n \"id\": string,\n \"summary\": string,\n \"description\": string,\n \"location\": string,\n \"timeZone\": string,\n \"conferenceProperties\": {\n \"allowedConferenceSolutionTypes\": [\n string\n ]\n }\n}\n```\n\n| Property name | Value | Description | Notes |\n|---------------------------------------------------------|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|\n| `conferenceProperties` | `nested object` | Conferencing properties for this calendar, for example what types of conferences are allowed. | |\n| conferenceProperties.`allowedConferenceSolutionTypes[]` | `list` | The types of conference solutions that are supported for this calendar. The possible values are: - `\"eventHangout\"` - `\"eventNamedHangout\"` - `\"hangoutsMeet\"` Optional. \u003cbr /\u003e | |\n| `description` | `string` | Description of the calendar. Optional. | writable |\n| `etag` | `etag` | ETag of the resource. | |\n| `id` | `string` | Identifier of the calendar. To retrieve IDs call the [calendarList.list()](/calendar/v3/reference/calendarList/list) method. | |\n| `kind` | `string` | Type of the resource (\"`calendar#calendar`\"). | |\n| `location` | `string` | Geographic location of the calendar as free-form text. Optional. | writable |\n| `summary` | `string` | Title of the calendar. | writable |\n| `timeZone` | `string` | The time zone of the calendar. (Formatted as an IANA Time Zone Database name, e.g. \"Europe/Zurich\".) Optional. | writable |\n\nMethods\n-------\n\n[clear](/workspace/calendar/api/v3/reference/calendars/clear)\n: Clears a primary calendar. This operation deletes all events associated with the primary calendar of an account.\n\n[delete](/workspace/calendar/api/v3/reference/calendars/delete)\n: Deletes a secondary calendar. Use calendars.clear for clearing all events on primary calendars.\n\n[get](/workspace/calendar/api/v3/reference/calendars/get)\n: Returns metadata for a calendar.\n\n[insert](/workspace/calendar/api/v3/reference/calendars/insert)\n: Creates a secondary calendar.\n\n[patch](/workspace/calendar/api/v3/reference/calendars/patch)\n: Updates metadata for a calendar. This method supports patch semantics. Note that each patch request consumes three quota units; prefer using a `get` followed by an `update`. The field values you specify replace the existing values. Fields that you don't specify in the request remain unchanged. Array fields, if specified, overwrite the existing arrays; this discards any previous array elements.\n\n[update](/workspace/calendar/api/v3/reference/calendars/update)\n: Updates metadata for a calendar."]]