السماح لنص برمجي بقراءة "تقويم Google" للمستخدم وتعديله توفّر هذه الفئة إمكانية الوصول المباشر إلى تقويم المستخدم التلقائي، بالإضافة إلى إمكانية استرداد التقاويم الإضافية التي يملكها المستخدم أو اشترك فيها.
الخصائص
الموقع | النوع | الوصف |
---|---|---|
Color | Color | مصنّف يمثّل الألوان المُسمّاة المتوفّرة في خدمة "تقويم Google" |
Event | Event | مصنّف يمثّل ألوان الأحداث المُسمّاة المتوفّرة في خدمة "تقويم Google" |
Event | Event | تعداد Event |
Event | Event | التعداد Event |
Guest | Guest | فهرس يمثّل الحالات التي يمكن أن يكون فيها ضيف في حدث |
Month | Month | مصنّف يمثّل أشهر السنة |
Visibility | Visibility | فهرس يمثّل مستوى ظهور حدث |
Weekday | Weekday | مصنّف يمثّل أيام الأسبوع |
الطُرق
الطريقة | نوع القيمة التي يتم عرضها | وصف قصير |
---|---|---|
create | Calendar | ينشئ حدثًا جديدًا على مدار اليوم. |
create | Calendar | لإنشاء حدث جديد يستمر طوال اليوم ويمكن أن يمتد لعدة أيام. |
create | Calendar | لإنشاء حدث جديد يستمر طوال اليوم ويمكن أن يمتد لعدة أيام. |
create | Calendar | ينشئ حدثًا جديدًا يستمر طوال اليوم. |
create | Calendar | يؤدي هذا الإجراء إلى إنشاء سلسلة جديدة من الأحداث التي تستمر طوال اليوم. |
create | Calendar | يؤدي هذا الإجراء إلى إنشاء سلسلة جديدة من الأحداث التي تستمر طوال اليوم. |
create | Calendar | لإنشاء تقويم جديد يملكه المستخدم |
create | Calendar | لإنشاء تقويم جديد يملكه المستخدم |
create | Calendar | ينشئ حدثًا جديدًا. |
create | Calendar | ينشئ حدثًا جديدًا. |
create | Calendar | تُنشئ حدثًا من وصف ذي تصميم مرن. |
create | Calendar | تُنشئ سلسلة أحداث جديدة. |
create | Calendar | تُنشئ سلسلة أحداث جديدة. |
get | Calendar[] | الحصول على جميع التقاويم التي يملكها المستخدم أو اشترك فيها |
get | Calendar[] | الحصول على جميع التقاويم التي يملكها المستخدم |
get | Calendar | الحصول على التقويم الذي يحمل المعرّف المحدّد |
get | Calendar[] | الحصول على جميع التقاويم التي تحمل اسمًا معيّنًا ويملكها المستخدم أو يشترك فيها |
get | String | للحصول على لون التقويم |
get | Calendar | الحصول على التقويم التلقائي للمستخدم |
get | String | الحصول على وصف التقويم |
get | Calendar | تحصل على الحدث الذي يحمل رقم التعريف المحدّد. |
get | Calendar | تحصل على سلسلة الأحداث التي تحمل رقم التعريف المحدّد. |
get | Calendar | تحصل على جميع الأحداث التي تحدث ضمن نطاق زمني معيّن. |
get | Calendar | تحصل على جميع الأحداث التي تحدث خلال نطاق زمني معيّن وتستوفي المعايير المحدّدة. |
get | Calendar | تحصل على جميع الأحداث التي تحدث في يوم معيّن. |
get | Calendar | تحصل على جميع الأحداث التي تحدث في يوم معيّن وتستوفي معايير محدّدة. |
get | String | للحصول على معرّف التقويم |
get | String | الحصول على اسم التقويم |
get | Calendar | تحصل على التقويم الذي يحمل رقم التعريف المحدَّد، إذا كان المستخدم يملكه. |
get | Calendar[] | الحصول على جميع التقاويم التي يملكها المستخدم والتي تحمل اسمًا معيّنًا |
get | String | تحصل على المنطقة الزمنية للتقويم. |
is | Boolean | يحدِّد ما إذا كان التقويم مخفيًا في واجهة المستخدم. |
is | Boolean | لتحديد ما إذا كان التقويم هو التقويم الأساسي للمستخدم الفعلي |
is | Boolean | لتحديد ما إذا كان التقويم مملوكًا لك. |
is | Boolean | يحدِّد ما إذا كان سيتم عرض أحداث التقويم في واجهة المستخدم. |
new | Event | لإنشاء عنصر تكرار جديد يمكن استخدامه لإنشاء قواعد لتكرار الأحداث. |
set | Calendar | لضبط لون التقويم |
set | Calendar | لضبط وصف تقويم |
set | Calendar | لضبط ما إذا كان التقويم مرئيًا في واجهة المستخدم. |
set | Calendar | لضبط اسم التقويم. |
set | Calendar | لضبط ما إذا كان سيتم عرض أحداث التقويم في واجهة المستخدم. |
set | Calendar | لضبط المنطقة الزمنية للتقويم |
subscribe | Calendar | يشترك المستخدم في التقويم باستخدام رقم التعريف المحدّد، إذا كان مسموحًا للمستخدم بالاشتراك. |
subscribe | Calendar | يشترك المستخدم في التقويم باستخدام رقم التعريف المحدَّد، إذا كان مسموحًا للمستخدم بالاشتراك. |
مستندات تفصيلية
create All Day Event(title, date)
ينشئ حدثًا جديدًا على مدار اليوم.
// Creates an all-day event for the moon landing and logs the ID. const event = CalendarApp.getDefaultCalendar().createAllDayEvent( 'Apollo 11 Landing', new Date('July 20, 1969'), ); Logger.log(`Event ID: ${event.getId()}`);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
title | String | عنوان الحدث |
date | Date | تاريخ الحدث (يتم استخدام اليوم فقط ويتم تجاهل الوقت). |
الإرجاع
Calendar
: الحدث الذي تم إنشاؤه.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
create All Day Event(title, startDate, endDate)
لإنشاء حدث جديد يستمر طوال اليوم ويمكن أن يمتد لعدة أيام.
// Creates an all-day event for the Woodstock festival (August 15th to 17th) and // logs the ID. const event = CalendarApp.getDefaultCalendar().createAllDayEvent( 'Woodstock Festival', new Date('August 15, 1969'), new Date('August 18, 1969'), ); Logger.log(`Event ID: ${event.getId()}`);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
title | String | عنوان الحدث |
start | Date | تاريخ بدء الحدث (يتم استخدام اليوم فقط ويتم تجاهل الوقت). |
end | Date | تاريخ انتهاء الحدث (يتم استخدام اليوم فقط ويتم تجاهل الوقت). تاريخ الانتهاء حصري. |
الإرجاع
Calendar
: الحدث الذي تم إنشاؤه.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
create All Day Event(title, startDate, endDate, options)
لإنشاء حدث جديد يستمر طوال اليوم ويمكن أن يمتد لعدة أيام.
// Creates an all-day event for the Woodstock festival (August 15th to 17th) and // logs the ID. const event = CalendarApp.getDefaultCalendar().createAllDayEvent( 'Woodstock Festival', new Date('August 15, 1969'), new Date('August 18, 1969'), {location: 'Bethel, White Lake, New York, U.S.', sendInvites: true}, ); Logger.log(`Event ID: ${event.getId()}`);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
title | String | عنوان الحدث |
start | Date | تاريخ بدء الحدث (يتم استخدام اليوم فقط ويتم تجاهل الوقت). |
end | Date | تاريخ انتهاء الحدث (يتم استخدام اليوم فقط ويتم تجاهل الوقت). تاريخ الانتهاء حصري. |
options | Object | كائن JavaScript يحدّد المَعلمات المتقدّمة كما هو موضّح أدناه |
المعلمات المتقدمة
الاسم | النوع | الوصف |
---|---|---|
description | String | وصف الحدث |
location | String | الموقع الجغرافي حيث ستقام الفعالية. |
guests | String | قائمة مفصولة بفواصل بعناوين البريد الإلكتروني التي يجب إضافتها كضيوف |
send | Boolean | ما إذا كنت تريد إرسال دعوات بالبريد الإلكتروني (الإعداد التلقائي: false ) |
الإرجاع
Calendar
: الحدث الذي تم إنشاؤه
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
create All Day Event(title, date, options)
ينشئ حدثًا جديدًا على مدار اليوم.
// Creates an all-day event for the moon landing and logs the ID. const event = CalendarApp.getDefaultCalendar().createAllDayEvent( 'Apollo 11 Landing', new Date('July 20, 1969'), {location: 'The Moon'}, ); Logger.log(`Event ID: ${event.getId()}`);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
title | String | عنوان الحدث |
date | Date | تاريخ الحدث (يتم استخدام اليوم فقط ويتم تجاهل الوقت). |
options | Object | كائن JavaScript يحدّد المَعلمات المتقدّمة كما هو موضّح أدناه |
المعلمات المتقدمة
الاسم | النوع | الوصف |
---|---|---|
description | String | وصف الحدث |
location | String | الموقع الجغرافي حيث ستقام الفعالية. |
guests | String | قائمة مفصولة بفواصل بعناوين البريد الإلكتروني التي يجب إضافتها كضيوف |
send | Boolean | ما إذا كنت تريد إرسال دعوات بالبريد الإلكتروني (الإعداد التلقائي: false ) |
الإرجاع
Calendar
: الحدث الذي تم إنشاؤه
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
create All Day Event Series(title, startDate, recurrence)
يؤدي هذا الإجراء إلى إنشاء سلسلة جديدة من الأحداث التي تستمر طوال اليوم.
// Creates an event series for a no-meetings day, taking place every Wednesday // in 2013. const eventSeries = CalendarApp.getDefaultCalendar().createAllDayEventSeries( 'No Meetings', new Date('January 2, 2013 03:00:00 PM EST'), CalendarApp.newRecurrence() .addWeeklyRule() .onlyOnWeekday(CalendarApp.Weekday.WEDNESDAY) .until(new Date('January 1, 2014')), ); Logger.log(`Event Series ID: ${eventSeries.getId()}`);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
title | String | عنوان الأحداث في السلسلة |
start | Date | تاريخ الحدث الأول في السلسلة (يتم استخدام اليوم فقط، ويتم تجاهل الوقت) |
recurrence | Event | إعدادات التكرار لسلسلة الأحداث |
الإرجاع
Calendar
: سلسلة الأحداث التي تم إنشاؤها
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
create All Day Event Series(title, startDate, recurrence, options)
تُنشئ سلسلة جديدة من الأحداث التي تستمر طوال اليوم.
// Creates an event series for a no-meetings day, taking place every Wednesday // in 2013. const eventSeries = CalendarApp.getDefaultCalendar().createAllDayEventSeries( 'No Meetings', new Date('January 2, 2013 03:00:00 PM EST'), CalendarApp.newRecurrence() .addWeeklyRule() .onlyOnWeekday(CalendarApp.Weekday.WEDNESDAY) .until(new Date('January 1, 2014')), {guests: 'everyone@example.com'}, ); Logger.log(`Event Series ID: ${eventSeries.getId()}`);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
title | String | عنوان الأحداث في السلسلة |
start | Date | تاريخ الحدث الأول في السلسلة (يتم استخدام اليوم فقط، ويتم تجاهل الوقت) |
recurrence | Event | إعدادات التكرار لسلسلة الأحداث |
options | Object | كائن JavaScript يحدّد المَعلمات المتقدّمة، كما هو موضّح أدناه |
المعلمات المتقدمة
الاسم | النوع | الوصف |
---|---|---|
description | String | وصف الأحداث في السلسلة |
location | String | الموقع الجغرافي للأحداث في السلسلة |
guests | String | قائمة مفصولة بفواصل بعناوين البريد الإلكتروني التي يجب إضافتها كمدعوين إلى الأحداث في السلسلة |
send | Boolean | ما إذا كنت تريد إرسال دعوات بالبريد الإلكتروني (الإعداد التلقائي: false ) |
الإرجاع
Calendar
: سلسلة الأحداث التي تم إنشاؤها
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
create Calendar(name)
لإنشاء تقويم جديد يملكه المستخدم
// Creates a new calendar named "Travel Plans". const calendar = CalendarApp.createCalendar('Travel Plans'); Logger.log( 'Created the calendar "%s", with the ID "%s".', calendar.getName(), calendar.getId(), );
المعلمات
الاسم | النوع | الوصف |
---|---|---|
name | String | اسم التقويم الجديد |
الإرجاع
Calendar
: التقويم الذي تم إنشاؤه حديثًا
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
create Calendar(name, options)
لإنشاء تقويم جديد يملكه المستخدم
// Creates a new calendar named "Travel Plans" with a description and color. const calendar = CalendarApp.createCalendar('Travel Plans', { description: 'A calendar to plan my travel schedule.', color: CalendarApp.Color.BLUE, }); Logger.log( 'Created the calendar "%s", with the ID "%s".', calendar.getName(), calendar.getId(), );
المعلمات
الاسم | النوع | الوصف |
---|---|---|
name | String | اسم التقويم الجديد |
options | Object | كائن JavaScript يحدّد المَعلمات المتقدّمة، كما هو موضّح أدناه |
المعلمات المتقدمة
الاسم | النوع | الوصف |
---|---|---|
location | String | موقع التقويم |
description | String | وصف التقويم |
time | String | المنطقة الزمنية التي سيتم ضبط التقويم عليها، المحدّدة بالتنسيق "الطول" (مثل "America/New_York"، كما هو مُدرَج في Joda.org) |
color | String | سلسلة لون سداسية عشرية ("#rrggbb") أو قيمة من Calendar |
hidden | Boolean | ما إذا كان التقويم مخفيًا في واجهة المستخدم (الإعداد التلقائي:
false ) |
selected | Boolean | ما إذا كان سيتم عرض أحداث التقويم في واجهة
مستخدم التطبيق (الإعداد التلقائي: true ) |
الإرجاع
Calendar
: التقويم الذي تم إنشاؤه حديثًا
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
create Event(title, startTime, endTime)
ينشئ حدثًا جديدًا.
في حال عدم تحديد منطقة زمنية، يتم تفسير قيم الوقت في سياق المنطقة الزمنية للنص البرمجي، والتي قد تكون مختلفة عن المنطقة الزمنية للتقويم.
// Creates an event for the moon landing and logs the ID. const event = CalendarApp.getDefaultCalendar().createEvent( 'Apollo 11 Landing', new Date('July 20, 1969 20:00:00 UTC'), new Date('July 21, 1969 21:00:00 UTC'), ); Logger.log(`Event ID: ${event.getId()}`);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
title | String | عنوان الحدث |
start | Date | تاريخ ووقت بدء الحدث |
end | Date | تاريخ ووقت انتهاء الحدث |
الإرجاع
Calendar
: الحدث الذي تم إنشاؤه
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
create Event(title, startTime, endTime, options)
ينشئ حدثًا جديدًا.
في حال عدم تحديد منطقة زمنية، يتم تفسير قيم الوقت في سياق المنطقة الزمنية للنص البرمجي، والتي قد تكون مختلفة عن المنطقة الزمنية للتقويم.
// Creates an event for the moon landing and logs the ID. const event = CalendarApp.getDefaultCalendar().createEvent( 'Apollo 11 Landing', new Date('July 20, 1969 20:00:00 UTC'), new Date('July 20, 1969 21:00:00 UTC'), {location: 'The Moon'}, ); Logger.log(`Event ID: ${event.getId()}`);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
title | String | عنوان الحدث |
start | Date | تاريخ ووقت بدء الحدث |
end | Date | تاريخ ووقت انتهاء الحدث |
options | Object | كائن JavaScript يحدّد المَعلمات المتقدّمة، كما هو موضّح أدناه |
المعلمات المتقدمة
الاسم | النوع | الوصف |
---|---|---|
description | String | وصف الحدث |
location | String | الموقع الجغرافي للحدث |
guests | String | قائمة مفصولة بفواصل بعناوين البريد الإلكتروني التي يجب إضافتها كضيوف |
send | Boolean | ما إذا كنت تريد إرسال دعوات بالبريد الإلكتروني (الإعداد التلقائي: false ) |
الإرجاع
Calendar
: الحدث الذي تم إنشاؤه
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
create Event From Description(description)
تُنشئ حدثًا من وصف ذي تصميم مرن.
يجب أن يستخدم الوصف التنسيق نفسه المستخدَم في ميزة "الإضافة السريعة" في واجهة المستخدم.
// Creates a new event and logs its ID. const event = CalendarApp.getDefaultCalendar().createEventFromDescription( 'Lunch with Mary, Friday at 1PM', ); Logger.log(`Event ID: ${event.getId()}`);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
description | String | وصف بأسلوب حر للحدث |
الإرجاع
Calendar
: الحدث الذي تم إنشاؤه
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
create Event Series(title, startTime, endTime, recurrence)
تُنشئ سلسلة أحداث جديدة.
// Creates an event series for a team meeting, taking place every Tuesday and // Thursday in 2013. const eventSeries = CalendarApp.getDefaultCalendar().createEventSeries( 'Team Meeting', new Date('January 1, 2013 03:00:00 PM EST'), new Date('January 1, 2013 04:00:00 PM EST'), CalendarApp.newRecurrence() .addWeeklyRule() .onlyOnWeekdays( [CalendarApp.Weekday.TUESDAY, CalendarApp.Weekday.THURSDAY]) .until(new Date('January 1, 2014')), ); Logger.log(`Event Series ID: ${eventSeries.getId()}`);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
title | String | عنوان الأحداث في السلسلة |
start | Date | تاريخ ووقت بدء الحدث الأول في السلسلة |
end | Date | تاريخ ووقت انتهاء الحدث الأول في السلسلة |
recurrence | Event | إعدادات التكرار لسلسلة الأحداث |
الإرجاع
Calendar
: سلسلة الأحداث التي تم إنشاؤها
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
create Event Series(title, startTime, endTime, recurrence, options)
تُنشئ سلسلة أحداث جديدة.
// Creates an event series for a team meeting, taking place every Tuesday and // Thursday in 2013. const eventSeries = CalendarApp.getDefaultCalendar().createEventSeries( 'Team Meeting', new Date('January 1, 2013 03:00:00 PM EST'), new Date('January 1, 2013 04:00:00 PM EST'), CalendarApp.newRecurrence() .addWeeklyRule() .onlyOnWeekdays( [CalendarApp.Weekday.TUESDAY, CalendarApp.Weekday.THURSDAY]) .until(new Date('January 1, 2014')), {location: 'Conference Room'}, ); Logger.log(`Event Series ID: ${eventSeries.getId()}`);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
title | String | عنوان الأحداث في السلسلة |
start | Date | تاريخ ووقت بدء الحدث الأول في السلسلة |
end | Date | تاريخ ووقت انتهاء الحدث الأول في السلسلة |
recurrence | Event | إعدادات التكرار لسلسلة الأحداث |
options | Object | كائن JavaScript يحدّد المَعلمات المتقدّمة، كما هو موضّح أدناه |
المعلمات المتقدمة
الاسم | النوع | الوصف |
---|---|---|
description | String | وصف الأحداث في السلسلة |
location | String | الموقع الجغرافي للأحداث في السلسلة |
guests | String | قائمة مفصولة بفواصل بعناوين البريد الإلكتروني التي يجب إضافتها كمدعوين إلى الأحداث في السلسلة |
send | Boolean | ما إذا كنت تريد إرسال دعوات بالبريد الإلكتروني (الإعداد التلقائي: false ) |
الإرجاع
Calendar
: سلسلة الأحداث التي تم إنشاؤها
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
get All Calendars()
الحصول على جميع التقاويم التي يملكها المستخدم أو اشترك فيها
// Determines how many calendars the user can access. const calendars = CalendarApp.getAllCalendars(); Logger.log( 'This user owns or is subscribed to %s calendars.', calendars.length, );
الإرجاع
Calendar[]
: جميع التقاويم التي يمكن للمستخدم الوصول إليها
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
get All Owned Calendars()
الحصول على جميع التقاويم التي يملكها المستخدم
// Determines how many calendars the user owns. const calendars = CalendarApp.getAllOwnedCalendars(); Logger.log('This user owns %s calendars.', calendars.length);
الإرجاع
Calendar[]
- جميع التقاويم التي يملكها المستخدم
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
get Calendar By Id(id)
الحصول على التقويم الذي يحمل المعرّف المحدّد
// Gets the public calendar "US Holidays" by ID. const calendar = CalendarApp.getCalendarById( 'en.usa#holiday@group.v.calendar.google.com', ); Logger.log('The calendar is named "%s".', calendar.getName());
المعلمات
الاسم | النوع | الوصف |
---|---|---|
id | String | معرّف التقويم |
الإرجاع
Calendar
: التقويم الذي يحمل رقم التعريف المحدَّد، أو null
إذا لم يكن التقويم متوفّرًا، أو إذا لم يتمكّن المستخدِم من الوصول إليه، أو إذا لم يكن المستخدِم مشتركًا في التقويم
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
get Calendars By Name(name)
الحصول على جميع التقاويم التي تحمل اسمًا معيّنًا ويملكها المستخدم أو يشترك فيها لا تكون الأسماء حساسة لحالة الأحرف.
// Gets the public calendar named "US Holidays". const calendars = CalendarApp.getCalendarsByName('US Holidays'); Logger.log('Found %s matching calendars.', calendars.length);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
name | String | اسم التقويم |
الإرجاع
Calendar[]
: جميع التقاويم التي تحمل هذا الاسم ويمكن للمستخدم الوصول إليها
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
get Color()
للحصول على لون التقويم
// Opens the calendar by its ID. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('222larabrown@gmail.com'); // Gets the color of the calendar and logs it to the console. // For the default calendar, you can use CalendarApp.getColor() instead. const calendarColor = calendar.getColor(); console.log(calendarColor);
الإرجاع
String
: سلسلة لون سداسية عشرية ("#rrggbb").
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
get Default Calendar()
الحصول على التقويم التلقائي للمستخدم
// Determines the time zone of the user's default calendar. const calendar = CalendarApp.getDefaultCalendar(); Logger.log( 'My default calendar is set to the time zone "%s".', calendar.getTimeZone(), );
الإرجاع
Calendar
- التقويم التلقائي للمستخدم
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
get Description()
الحصول على وصف التقويم
// Opens the calendar by its ID. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('222larabrown@gmail.com'); // Sets the description of the calendar to 'Test description.' calendar.setDescription('Test description'); // Gets the description of the calendar and logs it to the console. // For the default calendar, you can use CalendarApp.getDescription() instead. const description = calendar.getDescription(); console.log(description);
الإرجاع
String
- وصف هذا التقويم
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
get Event By Id(iCalId)
تحصل على الحدث الذي يحمل رقم التعريف المحدّد. إذا كانت السلسلة تنتمي إلى تقويم غير التلقائي
، يجب استدعاء هذه الطريقة من ذلك التقويم. يؤدي استدعاء get
فقط
إلى عرض حدث في التقويم التلقائي.
قد يكون لعدة أحداث رقم التعريف نفسه إذا كانت جزءًا من سلسلة أحداث. في هذه الحالة، لا تعرض هذه المحاولة سوى أول حدث من هذه السلسلة.
// Opens the calendar by its ID. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('222larabrown@gmail.com'); // Creates an event for the moon landing. const event = calendar.createEvent( 'Apollo 11 Landing', new Date('July 20, 1969 20:05:00 UTC'), new Date('July 20, 1969 20:17:00 UTC'), ); // Gets the calendar event ID and logs it to the console. const iCalId = event.getId(); console.log(iCalId); // Gets the event by its ID and logs the title of the event to the console. // For the default calendar, you can use CalendarApp.getEventById(iCalId) // instead. const myEvent = calendar.getEventById(iCalId); console.log(myEvent.getTitle());
المعلمات
الاسم | النوع | الوصف |
---|---|---|
iCalId | String | رقم تعريف الحدث. |
الإرجاع
Calendar
: الحدث الذي يحمل رقم التعريف المحدَّد، أو null
إذا لم يكن الحدث متوفّرًا أو إذا لم يكن بإمكان المستخدم
الوصول إليه.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
get Event Series By Id(iCalId)
تحصل على سلسلة الأحداث التي تحمل رقم التعريف المحدّد. إذا كان رقم التعريف المقدَّم خاصًا بعنصر Calendar
واحد،
يتم عرض Calendar
يتضمّن حدثًا واحدًا في السلسلة. يُرجى العلم أنّه إذا كانت
سلسلة الأحداث تنتمي إلى تقويم غير التقويم التلقائي، يجب
استدعاء هذه الطريقة منCalendar
هذا. إنّ استدعاءget
مباشرةً لا يؤدي إلا إلى عرض سلسلة أحداث متوفّرة في التقويم التلقائي.
// Opens the calendar by its ID. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('222larabrown@gmail.com'); // Creates an event series for a daily team meeting from 1 PM to 2 PM. // The series adds the daily event from January 1, 2023 through December 31, // 2023. const eventSeries = calendar.createEventSeries( 'Team meeting', new Date('Jan 1, 2023 13:00:00'), new Date('Jan 1, 2023 14:00:00'), CalendarApp.newRecurrence().addDailyRule().until(new Date('Jan 1, 2024')), ); // Gets the ID of the event series. const iCalId = eventSeries.getId(); // Gets the event series by its ID and logs the series title to the console. // For the default calendar, you can use CalendarApp.getEventSeriesById(iCalId) // instead. console.log(calendar.getEventSeriesById(iCalId).getTitle());
المعلمات
الاسم | النوع | الوصف |
---|---|---|
iCalId | String | رقم تعريف سلسلة الأحداث |
الإرجاع
Calendar
: السلسلة التي تحمل رقم التعريف المحدّد، أو null
إذا لم تكن السلسلة متوفّرة أو إذا لم يكن بإمكان المستخدِم
الوصول إليها
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
get Events(startTime, endTime)
تحصل على جميع الأحداث التي تحدث ضمن نطاق زمني معيّن.
تعرض هذه الطريقة الأحداث التي تبدأ خلال النطاق الزمني المحدّد أو تنتهي خلال النطاق الزمني أو تشمل النطاق الزمني. في حال عدم تحديد منطقة زمنية، تتم تفسير قيم الوقت في سياق المنطقة الزمنية للنص البرمجي، والتي قد تكون مختلفة عن المنطقة الزمنية للتقويم.
// Determines how many events are happening in the next two hours. const now = new Date(); const twoHoursFromNow = new Date(now.getTime() + 2 * 60 * 60 * 1000); const events = CalendarApp.getDefaultCalendar().getEvents(now, twoHoursFromNow); Logger.log(`Number of events: ${events.length}`);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
start | Date | بداية النطاق الزمني |
end | Date | نهاية النطاق الزمني، غير شاملة |
الإرجاع
Calendar
: الأحداث التي تحدث خلال النطاق الزمني
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
get Events(startTime, endTime, options)
تحصل على جميع الأحداث التي تحدث خلال نطاق زمني معيّن وتستوفي المعايير المحدّدة.
تعرض هذه الطريقة الأحداث التي تبدأ خلال النطاق الزمني المحدّد أو تنتهي خلال النطاق الزمني أو تشمل النطاق الزمني. في حال عدم تحديد منطقة زمنية، تتم تفسير قيم الوقت في سياق المنطقة الزمنية للنص البرمجي، والتي قد تكون مختلفة عن المنطقة الزمنية للتقويم.
يُرجى العِلم أنّ الفلترة على author
أو search
أو status
تتم
بعد تطبيق start
وmax
. وهذا يعني أنّ عدد الأحداث
المعروضة قد يكون أقل من max
، حتى إذا كانت أحداث إضافية تستوفي المعايير.
// Determines how many events are happening in the next two hours that contain // the term "meeting". const now = new Date(); const twoHoursFromNow = new Date(now.getTime() + 2 * 60 * 60 * 1000); const events = CalendarApp.getDefaultCalendar().getEvents( now, twoHoursFromNow, {search: 'meeting'}, ); Logger.log(`Number of events: ${events.length}`);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
start | Date | بداية النطاق الزمني |
end | Date | نهاية النطاق الزمني، غير شاملة |
options | Object | كائن JavaScript يحدّد المَعلمات المتقدّمة، كما هو موضّح أدناه |
المعلمات المتقدمة
الاسم | النوع | الوصف |
---|---|---|
start | Integer | فهرس أول حدث يتم عرضه |
max | Integer | الحد الأقصى لعدد الأحداث التي سيتم عرضها |
author | String | عنوان بريد إلكتروني يُستخدَم لفلترة النتائج حسب صانع الحدث |
search | String | طلب بحث في النص الكامل يُستخدَم لفلترة النتائج |
status | Guest | صفيف من الحالات المستخدَمة لفلترة النتائج |
الإرجاع
Calendar
: الأحداث التي تحدث خلال النطاق الزمني وتتطابق مع المعايير
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
get Events For Day(date)
تحصل على جميع الأحداث التي تحدث في يوم معيّن.
تعرض هذه الطريقة الأحداث إذا كانت تبدأ خلال اليوم المحدّد أو تنتهي خلال اليوم أو تغطي اليوم.
يُرجى العِلم أنّه يتم استخدام جزء التاريخ فقط من عنصر Date، ويتم تجاهل جزء الوقت. يتم تفسير التاريخ على أنّه منتصف الليل في ذلك اليوم إلى منتصف الليل في اليوم التالي في المنطقة الزمنية للجدول الزمني.
// Determines how many events are happening today. const today = new Date(); const events = CalendarApp.getDefaultCalendar().getEventsForDay(today); Logger.log(`Number of events: ${events.length}`);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
date | Date | تاريخ استرداد الأحداث (يتم استخدام اليوم فقط، ويتم تجاهل الوقت) |
الإرجاع
Calendar
: الأحداث التي تحدث في التاريخ المحدّد
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
get Events For Day(date, options)
تحصل على جميع الأحداث التي تحدث في يوم معيّن وتستوفي معايير محدّدة.
تعرض هذه الطريقة الأحداث إذا كانت تبدأ خلال اليوم المحدّد أو تنتهي خلال اليوم أو تغطي اليوم.
يُرجى العِلم أنّه يتم استخدام جزء التاريخ فقط من عنصر Date، ويتم تجاهل جزء الوقت. يتم تفسير التاريخ على أنّه منتصف الليل في ذلك اليوم إلى منتصف الليل في اليوم التالي في المنطقة الزمنية للجدول الزمني.
يُرجى العِلم أنّ الفلترة على author
أو search
أو status
تتم
بعد تطبيق start
وmax
. وهذا يعني أنّ عدد الأحداث
المعروضة قد يكون أقل من max
، حتى إذا كانت هناك أحداث إضافية تستوفي المعايير.
// Determines how many events are happening today and contain the term // "meeting". const today = new Date(); const events = CalendarApp.getDefaultCalendar().getEventsForDay(today, { search: 'meeting', }); Logger.log(`Number of events: ${events.length}`);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
date | Date | تاريخ استرداد الأحداث (يتم استخدام اليوم فقط، ويتم تجاهل الوقت) |
options | Object | خيارات الفلترة المتقدّمة |
المعلمات المتقدمة
الاسم | النوع | الوصف |
---|---|---|
start | Integer | فهرس أول حدث يتم عرضه |
max | Integer | الحد الأقصى لعدد الأحداث التي سيتم عرضها |
author | String | عنوان بريد إلكتروني يُستخدَم لفلترة النتائج حسب صانع الحدث |
search | String | طلب بحث في النص الكامل يُستخدَم لفلترة النتائج |
status | Guest | صفيف من الحالات المستخدَمة لفلترة النتائج |
الإرجاع
Calendar
: الأحداث التي تحدث في التاريخ المحدّد وتتطابق مع المعايير
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
get Id()
للحصول على معرّف التقويم معرّف التقويم التلقائي للمستخدم هو عنوان بريده الإلكتروني.
// Opens the calendar by its ID. // To get the user's default calendar, use CalendarApp.getDefaultCalendar(). // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('222larabrown@gmail.com'); // Gets the ID of the calendar and logs it to the console. const calendarId = calendar.getId(); console.log(calendarId);
الإرجاع
String
: رقم تعريف التقويم
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
get Name()
الحصول على اسم التقويم
// Opens the calendar by its ID. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('222larabrown@gmail.com'); // Gets the name of the calendar and logs it to the console. // For the default calendar, you can use CalendarApp.getName() instead. const calendarName = calendar.getName(); console.log(calendarName);
الإرجاع
String
: اسم هذا التقويم.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
get Owned Calendar By Id(id)
تحصل على التقويم الذي يحمل رقم التعريف المحدّد، إذا كان المستخدم يملكه.
للعثور على معرّف تقويم، انقر على السهم بجانب اسم التقويم في "تقويم Google" و اختَر إعدادات التقويم. يظهر رقم التعريف بالقرب من أسفل صفحة الإعدادات.
// Gets a (non-existent) private calendar by ID. const calendar = CalendarApp.getOwnedCalendarById( '123456789@group.calendar.google.com', ); Logger.log('The calendar is named "%s".', calendar.getName());
المعلمات
الاسم | النوع | الوصف |
---|---|---|
id | String | معرّف التقويم |
الإرجاع
Calendar
: التقويم الذي يحمل رقم التعريف المحدَّد، أو null
إذا لم يكن التقويم موجودًا أو
لم يكن المستخدم يملكه
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
get Owned Calendars By Name(name)
الحصول على جميع التقاويم التي يملكها المستخدم والتي تحمل اسمًا معيّنًا والأسماء ليست حسّاسة لحالة الأحرف.
// Gets a private calendar named "Travel Plans". const calendars = CalendarApp.getOwnedCalendarsByName('Travel Plans'); Logger.log('Found %s matching calendars.', calendars.length);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
name | String | اسم التقويم |
الإرجاع
Calendar[]
: جميع التقاويم التي يملكها المستخدم بهذا الاسم
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
get Time Zone()
تحصل على المنطقة الزمنية للتقويم.
// Opens the calendar by its ID. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('222larabrown@gmail.com'); // Gets the time zone of the calendar and logs it to the console. // For the default calendar, you can use CalendarApp.getTimeZone() instead. const timeZone = calendar.getTimeZone(); console.log(timeZone);
الإرجاع
String
: المنطقة الزمنية، المحدّدة بالتنسيق "الطول" (على سبيل المثال، "أمريكا/نيويورك"، كما هو مُدرَج في Joda.org)
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
is Hidden()
يحدِّد ما إذا كان التقويم مخفيًا في واجهة المستخدم.
// Opens the calendar by its ID. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('222larabrown@gmail.com'); // Determines whether the calendar is hidden in the user interface and logs it // to the console. For the default calendar, you can use CalendarApp.isHidden() // instead. const isHidden = calendar.isHidden(); console.log(isHidden);
الإرجاع
Boolean
— true
إذا كان التقويم مخفيًا في واجهة المستخدم، false
إذا كان
غير مخفي
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
is My Primary Calendar()
لتحديد ما إذا كان التقويم هو التقويم الأساسي للمستخدم الفعلي
// Opens the calendar by its ID. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('222larabrown@gmail.com'); // Determines whether the calendar is the default calendar for // the effective user and logs it to the console. // For the default calendar, you can use CalendarApp.isMyPrimaryCalendar() // instead. const isMyPrimaryCalendar = calendar.isMyPrimaryCalendar(); console.log(isMyPrimaryCalendar);
الإرجاع
Boolean
— true
إذا كان التقويم هو التقويم التلقائي للمستخدم الفعلي، false
إذا لم يكن كذلك.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
is Owned By Me()
لتحديد ما إذا كان التقويم مملوكًا لك.
// Gets a calendar by its ID. To get the user's default calendar, use // CalendarApp.getDefault() instead. // TODO(developer): Replace the ID with the calendar ID that you want to use. const calendar = CalendarApp.getCalendarById( 'abc123456@group.calendar.google.com', ); // Determines whether the calendar is owned by you and logs it. console.log(calendar.isOwnedByMe());
الإرجاع
Boolean
: true
إذا كان التقويم مملوكًا لك، false
إذا لم يكن كذلك
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
is Selected()
يحدِّد ما إذا كان سيتم عرض أحداث التقويم في واجهة المستخدم.
// Gets the user's default calendar. To get a different calendar, // use getCalendarById() instead. const calendar = CalendarApp.getDefaultCalendar(); // Determines whether the calendar's events are displayed in the user interface // and logs it. console.log(calendar.isSelected());
الإرجاع
Boolean
— true
إذا كانت أحداث التقويم معروضة في واجهة المستخدم، false
إذا لم تكن معروضة
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
new Recurrence()
لإنشاء عنصر تكرار جديد يمكن استخدامه لإنشاء قواعد لتكرار الحدث.
// Creates an event series for a no-meetings day, taking place every Wednesday // in 2013. const recurrence = CalendarApp.newRecurrence() .addWeeklyRule() .onlyOnWeekday(CalendarApp.Weekday.WEDNESDAY) .until(new Date('January 1, 2014')); const eventSeries = CalendarApp.getDefaultCalendar().createAllDayEventSeries( 'No Meetings', new Date('January 2, 2013 03:00:00 PM EST'), recurrence, ); Logger.log(`Event Series ID: ${eventSeries.getId()}`);
الإرجاع
Event
: عنصر تكرار جديد بدون قواعد محدّدة (يعمل كتكرار أسبوعي)
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
set Color(color)
لضبط لون التقويم
// Opens the calendar by its ID. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('222larabrown@gmail.com'); // Sets the color of the calendar to pink using the Calendar Color enum. // For the default calendar, you can use CalendarApp.setColor() instead. calendar.setColor(CalendarApp.Color.PINK);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
color | String | Calendar أو سلسلة لون سداسية عشرية
("#rrggbb"). |
الإرجاع
Calendar
: هذا التقويم مخصّص للربط.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
set Description(description)
لضبط وصف تقويم
// Gets the user's default calendar. To get a different calendar, // use getCalendarById() instead. const calendar = CalendarApp.getDefaultCalendar(); // Sets the description of the calendar. // TODO(developer): Update the string with the description that you want to use. calendar.setDescription('Updated calendar description.');
المعلمات
الاسم | النوع | الوصف |
---|---|---|
description | String | وصف هذا التقويم |
الإرجاع
Calendar
- هذا التقويم لإنشاء سلسلة
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
set Hidden(hidden)
لضبط ما إذا كان التقويم مرئيًا في واجهة المستخدم.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
hidden | Boolean | true لإخفاء التقويم في واجهة المستخدم، false لإظهاره |
الإرجاع
Calendar
- هذا التقويم لإنشاء سلسلة
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
set Name(name)
لضبط اسم التقويم.
// Gets the user's default calendar. To get a different calendar, // use getCalendarById() instead. const calendar = CalendarApp.getDefaultCalendar(); // Sets the name of the calendar. // TODO(developer): Update the string with the name that you want to use. calendar.setName('Example calendar name');
المعلمات
الاسم | النوع | الوصف |
---|---|---|
name | String | الاسم الجديد |
الإرجاع
Calendar
- هذا التقويم لإنشاء سلسلة
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
set Selected(selected)
لضبط ما إذا كان سيتم عرض أحداث التقويم في واجهة المستخدم.
// Gets the user's default calendar. To get a different calendar, // use getCalendarById() instead. const calendar = CalendarApp.getDefaultCalendar(); // Selects the calendar so that its events are displayed in the user interface. // To unselect the calendar, set the parameter to false. calendar.setSelected(true);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
selected | Boolean | true لإظهار أحداث التقويم في واجهة المستخدم false
لإخفائها |
الإرجاع
Calendar
- هذا التقويم لإنشاء سلسلة
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
set Time Zone(timeZone)
لضبط المنطقة الزمنية للتقويم
// Gets the user's default calendar. To get a different calendar, // use getCalendarById() instead. const calendar = CalendarApp.getDefaultCalendar(); // Sets the time zone of the calendar to America/New York (US/Eastern) time. calendar.setTimeZone('America/New_York');
المعلمات
الاسم | النوع | الوصف |
---|---|---|
time | String | المنطقة الزمنية، المحدّدة بتنسيق "طويل" (مثل "أمريكا/نيويورك"، كما هو مُدرَج في Joda.org) |
الإرجاع
Calendar
: هذا التقويم مخصّص للربط.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
subscribe To Calendar(id)
يشترك المستخدم في التقويم باستخدام رقم التعريف المحدَّد، إذا كان مسموحًا للمستخدم بالاشتراك.
// Subscribe to the calendar "US Holidays". const calendar = CalendarApp.subscribeToCalendar( 'en.usa#holiday@group.v.calendar.google.com', ); Logger.log('Subscribed to the calendar "%s".', calendar.getName());
المعلمات
الاسم | النوع | الوصف |
---|---|---|
id | String | رقم تعريف التقويم المطلوب الاشتراك فيه |
الإرجاع
Calendar
: التقويم الذي تم الاشتراك فيه حديثًا
عمليات الرمي
Error
- إذا لم يكن هناك تقويم يحمل هذا المعرّف
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
subscribe To Calendar(id, options)
يشترك المستخدم في التقويم باستخدام رقم التعريف المحدَّد، إذا كان مسموحًا للمستخدم بالاشتراك.
// Subscribe to the calendar "US Holidays", and set it to the color blue. const calendar = CalendarApp.subscribeToCalendar( 'en.usa#holiday@group.v.calendar.google.com', {color: CalendarApp.Color.BLUE}, ); Logger.log('Subscribed to the calendar "%s".', calendar.getName());
المعلمات
الاسم | النوع | الوصف |
---|---|---|
id | String | رقم تعريف التقويم المطلوب الاشتراك فيه. |
options | Object | كائن JavaScript يحدّد المَعلمات المتقدّمة كما هو موضّح أدناه |
المعلمات المتقدمة
الاسم | النوع | الوصف |
---|---|---|
color | String | سلسلة لون سداسية عشرية ("#rrggbb") أو قيمة من Calendar |
hidden | Boolean | ما إذا كان التقويم مخفيًا في واجهة المستخدم (الإعداد التلقائي:
false ). |
selected | Boolean | ما إذا كان سيتم عرض أحداث التقويم في واجهة
مستخدم (الإعداد التلقائي: true إذا تم تحديد color أيضًا، false
في غير ذلك) |
الإرجاع
Calendar
: التقويم الذي تم الاشتراك فيه حديثًا.
عمليات الرمي
Error
- إذا لم يكن هناك تقويم يحمل هذا المعرّف
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds