إرسال ملاحظات
Calendar Service
bookmark_border bookmark
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تقويم Google
تسمح هذه الخدمة بنصوص برمجية للوصول إلى "تقويم Google" للمستخدم وتعديله،
بما في ذلك التقاويم الإضافية التي اشترك فيها المستخدم.
صفوف
الطُرق
الطريقة نوع القيمة التي يتم عرضها وصف قصير
createAllDayEvent(title, date)
CalendarEvent
ينشئ حدثًا جديدًا على مدار اليوم.
createAllDayEvent(title, startDate, endDate)
CalendarEvent
لإنشاء حدث جديد يستمر طوال اليوم ويمكن أن يمتد لعدة أيام.
createAllDayEvent(title, startDate, endDate, options)
CalendarEvent
لإنشاء حدث جديد يستمر طوال اليوم ويمكن أن يمتد لعدة أيام.
createAllDayEvent(title, date, options)
CalendarEvent
ينشئ حدثًا جديدًا على مدار اليوم.
createAllDayEventSeries(title, startDate, recurrence)
CalendarEventSeries
يؤدي هذا الإجراء إلى إنشاء سلسلة جديدة من الأحداث التي تستمر طوال اليوم.
createAllDayEventSeries(title, startDate, recurrence, options)
CalendarEventSeries
يؤدي هذا الإجراء إلى إنشاء سلسلة جديدة من الأحداث التي تستمر طوال اليوم.
createEvent(title, startTime, endTime)
CalendarEvent
ينشئ حدثًا جديدًا.
createEvent(title, startTime, endTime, options)
CalendarEvent
ينشئ حدثًا جديدًا.
createEventFromDescription(description)
CalendarEvent
تُنشئ حدثًا من وصف ذي تصميم مرن.
createEventSeries(title, startTime, endTime, recurrence)
CalendarEventSeries
تُنشئ سلسلة أحداث جديدة.
createEventSeries(title, startTime, endTime, recurrence, options)
CalendarEventSeries
تُنشئ سلسلة أحداث جديدة.
deleteCalendar()
void
يؤدي ذلك إلى حذف التقويم نهائيًا.
getColor()
String
للحصول على لون التقويم
getDescription()
String
الحصول على وصف التقويم
getEventById(iCalId)
CalendarEvent
تحصل على الحدث الذي يحمل رقم التعريف المحدّد.
getEventSeriesById(iCalId)
CalendarEventSeries
تحصل على سلسلة الأحداث التي تحمل رقم التعريف المحدّد.
getEvents(startTime, endTime)
CalendarEvent[]
تحصل على جميع الأحداث التي تحدث ضمن نطاق زمني معيّن.
getEvents(startTime, endTime, options)
CalendarEvent[]
تحصل على جميع الأحداث التي تحدث خلال نطاق زمني معيّن وتستوفي المعايير المحدّدة.
getEventsForDay(date)
CalendarEvent[]
تحصل على جميع الأحداث التي تحدث في يوم معيّن.
getEventsForDay(date, options)
CalendarEvent[]
تحصل على جميع الأحداث التي تحدث في يوم معيّن وتستوفي معايير محدّدة.
getId()
String
للحصول على معرّف التقويم
getName()
String
الحصول على اسم التقويم
getTimeZone()
String
تحصل على المنطقة الزمنية للتقويم.
isHidden()
Boolean
يحدِّد ما إذا كان التقويم مخفيًا في واجهة المستخدم.
isMyPrimaryCalendar()
Boolean
لتحديد ما إذا كان التقويم هو التقويم الأساسي للمستخدم الفعلي
isOwnedByMe()
Boolean
لتحديد ما إذا كان التقويم مملوكًا لك.
isSelected()
Boolean
يحدِّد ما إذا كان سيتم عرض أحداث التقويم في واجهة المستخدم.
setColor(color)
Calendar
لضبط لون التقويم
setDescription(description)
Calendar
لضبط وصف تقويم
setHidden(hidden)
Calendar
لضبط ما إذا كان التقويم مرئيًا في واجهة المستخدم.
setName(name)
Calendar
لضبط اسم التقويم.
setSelected(selected)
Calendar
لضبط ما إذا كان سيتم عرض أحداث التقويم في واجهة المستخدم.
setTimeZone(timeZone)
Calendar
لضبط المنطقة الزمنية للتقويم
unsubscribeFromCalendar()
void
إلغاء اشتراك المستخدم في تقويم
الطُرق
الطريقة نوع القيمة التي يتم عرضها وصف قصير
createAllDayEvent(title, date)
CalendarEvent
ينشئ حدثًا جديدًا على مدار اليوم.
createAllDayEvent(title, startDate, endDate)
CalendarEvent
لإنشاء حدث جديد يستمر طوال اليوم ويمكن أن يمتد لعدة أيام.
createAllDayEvent(title, startDate, endDate, options)
CalendarEvent
لإنشاء حدث جديد يستمر طوال اليوم ويمكن أن يمتد لعدة أيام.
createAllDayEvent(title, date, options)
CalendarEvent
ينشئ حدثًا جديدًا على مدار اليوم.
createAllDayEventSeries(title, startDate, recurrence)
CalendarEventSeries
يؤدي هذا الإجراء إلى إنشاء سلسلة جديدة من الأحداث التي تستمر طوال اليوم.
createAllDayEventSeries(title, startDate, recurrence, options)
CalendarEventSeries
يؤدي هذا الإجراء إلى إنشاء سلسلة جديدة من الأحداث التي تستمر طوال اليوم.
createCalendar(name)
Calendar
لإنشاء تقويم جديد يملكه المستخدم
createCalendar(name, options)
Calendar
لإنشاء تقويم جديد يملكه المستخدم
createEvent(title, startTime, endTime)
CalendarEvent
ينشئ حدثًا جديدًا.
createEvent(title, startTime, endTime, options)
CalendarEvent
ينشئ حدثًا جديدًا.
createEventFromDescription(description)
CalendarEvent
تُنشئ حدثًا من وصف ذي تصميم مرن.
createEventSeries(title, startTime, endTime, recurrence)
CalendarEventSeries
تُنشئ سلسلة أحداث جديدة.
createEventSeries(title, startTime, endTime, recurrence, options)
CalendarEventSeries
تُنشئ سلسلة أحداث جديدة.
getAllCalendars()
Calendar[]
الحصول على جميع التقاويم التي يملكها المستخدم أو اشترك فيها
getAllOwnedCalendars()
Calendar[]
الحصول على جميع التقاويم التي يملكها المستخدم
getCalendarById(id)
Calendar
الحصول على التقويم الذي يحمل المعرّف المحدّد
getCalendarsByName(name)
Calendar[]
الحصول على جميع التقاويم التي تحمل اسمًا معيّنًا ويملكها المستخدم أو يشترك فيها
getColor()
String
للحصول على لون التقويم
getDefaultCalendar()
Calendar
الحصول على التقويم التلقائي للمستخدم
getDescription()
String
الحصول على وصف التقويم
getEventById(iCalId)
CalendarEvent
تحصل على الحدث الذي يحمل رقم التعريف المحدّد.
getEventSeriesById(iCalId)
CalendarEventSeries
تحصل على سلسلة الأحداث التي تحمل رقم التعريف المحدّد.
getEvents(startTime, endTime)
CalendarEvent[]
تحصل على جميع الأحداث التي تحدث ضمن نطاق زمني معيّن.
getEvents(startTime, endTime, options)
CalendarEvent[]
تحصل على جميع الأحداث التي تحدث خلال نطاق زمني معيّن وتستوفي المعايير المحدّدة.
getEventsForDay(date)
CalendarEvent[]
تحصل على جميع الأحداث التي تحدث في يوم معيّن.
getEventsForDay(date, options)
CalendarEvent[]
تحصل على جميع الأحداث التي تحدث في يوم معيّن وتستوفي معايير محدّدة.
getId()
String
للحصول على معرّف التقويم
getName()
String
الحصول على اسم التقويم
getOwnedCalendarById(id)
Calendar
تحصل على التقويم الذي يحمل رقم التعريف المحدَّد، إذا كان المستخدم يملكه.
getOwnedCalendarsByName(name)
Calendar[]
الحصول على جميع التقاويم التي يملكها المستخدم والتي تحمل اسمًا معيّنًا
getTimeZone()
String
تحصل على المنطقة الزمنية للتقويم.
isHidden()
Boolean
يحدِّد ما إذا كان التقويم مخفيًا في واجهة المستخدم.
isMyPrimaryCalendar()
Boolean
لتحديد ما إذا كان التقويم هو التقويم الأساسي للمستخدم الفعلي
isOwnedByMe()
Boolean
لتحديد ما إذا كان التقويم مملوكًا لك.
isSelected()
Boolean
يحدِّد ما إذا كان سيتم عرض أحداث التقويم في واجهة المستخدم.
newRecurrence()
EventRecurrence
لإنشاء عنصر تكرار جديد يمكن استخدامه لإنشاء قواعد لتكرار الأحداث.
setColor(color)
Calendar
لضبط لون التقويم
setDescription(description)
Calendar
لضبط وصف تقويم
setHidden(hidden)
Calendar
لضبط ما إذا كان التقويم مرئيًا في واجهة المستخدم.
setName(name)
Calendar
لضبط اسم التقويم.
setSelected(selected)
Calendar
لضبط ما إذا كان سيتم عرض أحداث التقويم في واجهة المستخدم.
setTimeZone(timeZone)
Calendar
لضبط المنطقة الزمنية للتقويم
subscribeToCalendar(id)
Calendar
يشترك المستخدم في التقويم باستخدام رقم التعريف المحدَّد، إذا كان مسموحًا للمستخدم بالاشتراك.
subscribeToCalendar(id, options)
Calendar
يشترك المستخدم في التقويم باستخدام رقم التعريف المحدّد، إذا كان مسموحًا للمستخدم بالاشتراك.
الخصائص
الموقع النوع الوصف
BLUE
Enum
الأزرق (#2952A3
)
BROWN
Enum
بني (#8D6F47
)
CHARCOAL
Enum
أسود (#4E5D6C
)
CHESTNUT
Enum
الكستناء (#865A5A
)
GRAY
Enum
رمادي (#5A6986
)
GREEN
Enum
أخضر (#0D7813
)
INDIGO
Enum
الأزرق النيلي (#5229A3
)
LIME
Enum
أخضر ليموني (#528800
)
MUSTARD
Enum
الخردل (#88880E
)
OLIVE
Enum
زيتون (#6E6E41
).
ORANGE
Enum
برتقالي (#BE6D00
)
PINK
Enum
وردي (#B1365F
)
PLUM
Enum
أحمر خوخي (#705770
)
PURPLE
Enum
أرجواني (#7A367A
)
RED
Enum
أحمر (#A32929
)
RED_ORANGE
Enum
أحمر برتقالي (#B1440E
)
SEA_BLUE
Enum
أزرق البحر (#29527A
)
SLATE
Enum
Slate (#4A716C
)
TEAL
Enum
أزرق مخضرّ (#28754E
).
TURQOISE
Enum
الفيروزي (#1B887A
)
YELLOW
Enum
أصفر (#AB8B00
)
الخصائص
الموقع النوع الوصف
PALE_BLUE
Enum
الأزرق الباهت ("1"
)، ويُشار إليه باسم "الببغاء" في واجهة مستخدم "تقويم Google"
PALE_GREEN
Enum
أخضر باهت ("2"
)، يُشار إليه باسم "أخضر ليموني" في واجهة مستخدم "تقويم Google"
MAUVE
Enum
البنفسجي ("3"
)، ويُشار إليه باسم "العنب" في واجهة مستخدم "تقويم Google"
PALE_RED
Enum
اللون الأحمر الباهت ("4"
)، ويُشار إليه باسم "فلامينغو" في واجهة مستخدم "تقويم Google"
YELLOW
Enum
اللون الأصفر ("5"
)، ويُشار إليه باسم "الموز" في واجهة مستخدم "تقويم Google"
ORANGE
Enum
البرتقالي ("6"
)، ويُشار إليه باسم "برتقالي محمرّ" في واجهة مستخدم "تقويم Google"
CYAN
Enum
الأزرق السماوي ("7"
)، ويُشار إليه باسم "الخزامى" في واجهة مستخدم "تقويم Google"
GRAY
Enum
الرمادي ("8"
)، ويُشار إليه باسم "الغرافيت" في واجهة مستخدم "تقويم Google"
BLUE
Enum
الأزرق ("9"
)، ويُشار إليه باسم "توت أزرق" في واجهة مستخدم "تقويم Google"
GREEN
Enum
الأخضر ("10"
)، ويُشار إليه باسم "ريحان" في واجهة مستخدم "تقويم Google"
RED
Enum
اللون الأحمر ("11"
)، ويُشار إليه باسم "طماطم" في واجهة مستخدم "تقويم Google"
الخصائص
الموقع النوع الوصف
OPAQUE
Enum
يحظر الحدث وقتًا في التقويم.
TRANSPARENT
Enum
لا يحظر الحدث وقتًا في التقويم.
الخصائص
الموقع النوع الوصف
DEFAULT
Enum
إذا كان الحدث عاديًا
BIRTHDAY
Enum
الحدث هو حدث خاص على مدار اليوم مع تكرار سنوي.
FOCUS_TIME
Enum
الحدث هو حدث وقت التركيز.
FROM_GMAIL
Enum
الحدث هو حدث من Gmail.
OUT_OF_OFFICE
Enum
الحدث هو حدث خارج المكتب.
WORKING_LOCATION
Enum
الحدث هو حدث مكان عمل.
الخصائص
الموقع النوع الوصف
INVITED
Enum
تمّت دعوة الضيف، ولكنّه لم يُشير إلى ما إذا كان سيحضر.
MAYBE
Enum
أشار المدعو إلى أنّه قد يحضر.
NO
Enum
أشار الضيف إلى أنّه لن يحضر.
OWNER
Enum
يكون المدعو هو مالك الحدث.
YES
Enum
أشار الضيف إلى أنّه سيحضر.
الخصائص
الموقع النوع الوصف
CONFIDENTIAL
Enum
الحدث خاص.
DEFAULT
Enum
يستخدم مستوى الظهور التلقائي للأحداث في التقويم.
PRIVATE
Enum
الحدث خاص ويمكن فقط للحاضرين الاطّلاع على تفاصيله.
PUBLIC
Enum
الحدث متاح للجميع وتكون تفاصيله مرئية لجميع قراء التقويم.
إرسال ملاحظات
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0 . للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers . إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-12-22 (حسب التوقيت العالمي المتفَّق عليه)
هل تريد مشاركة ملاحظاتك معنا؟
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2024-12-22 (حسب التوقيت العالمي المتفَّق عليه)"],[[["The Google Apps Script Calendar Service enables interaction with Google Calendars, allowing scripts to create, modify, and delete events and calendars."],["It offers classes like `Calendar`, `CalendarApp`, and `CalendarEvent` with specific methods for managing various calendar aspects."],["Recurring events are handled through `CalendarEventSeries` and `RecurrenceRule`, which provide extensive options for recurrence patterns and exclusions."],["The service utilizes enums like `Color`, `EventColor`, and `Visibility` to define event properties."],["`CalendarEvent` methods allow detailed control over event details, such as reminders, guests, and visibility settings."]]],[]]