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، مثل "أوروبا/زيورخ"). اختياريّ. |
قابل للكتابة
|
الطُرق
- واضح
- محو تقويم أساسي. تؤدي هذه العملية إلى حذف جميع الأحداث المرتبطة بالتقويم الأساسي للحساب.
- حذف
- حذف تقويم ثانوي استخدم calendar.clear لمحو جميع الأحداث في التقاويم الأساسية.
- الحصول على
- عرض البيانات الوصفية لأحد التقاويم
- إدراج
- إنشاء تقويم ثانوي
- التصحيح
- يحدّث البيانات الوصفية لأحد التقاويم. تتوافق هذه الطريقة مع دلالات التصحيح. تجدر الإشارة إلى أنّ كل طلب رمز تصحيح يستهلك ثلاث وحدات حصة. ويفضلون استخدام
get
متبوعة بـ update
. وتحل قيم الحقول التي تحددها محل القيم الحالية. تظل الحقول التي لا تحدِّدها في الطلب بدون تغيير. يجب استبدال المصفوفات الموجودة في حقول المصفوفة، في حال تحديدها. يؤدي هذا إلى إلغاء أي عناصر صفيف سابقة.
- تعديل
- يحدّث البيانات الوصفية لأحد التقاويم.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة 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."]]