Class CalendarApp

ينشئ حدثًا جديدًا على مدار اليوم.

// Creates an all-day event for the moon landing and logs the ID.
var event = CalendarApp.getDefaultCalendar().createAllDayEvent('Apollo 11 Landing',
    new Date('July 20, 1969'));
Logger.log('Event ID: ' + event.getId());

المعلمات

الإرجاع

CalendarEvent — الحدث الذي تم إنشاؤه

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

• https://www.googleapis.com/auth/calendar
• https://www.google.com/calendar/feeds

لإنشاء حدث جديد يستمر طوال اليوم ويمكن أن يمتد لعدّة أيام.

// Creates an all-day event for the Woodstock festival (August 15th to 17th) and logs the ID.
var event = CalendarApp.getDefaultCalendar().createAllDayEvent('Woodstock Festival',
    new Date('August 15, 1969'),
    new Date('August 18, 1969'));
Logger.log('Event ID: ' + event.getId());

المعلمات

الإرجاع

CalendarEvent — الحدث الذي تم إنشاؤه

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

• https://www.googleapis.com/auth/calendar
• https://www.google.com/calendar/feeds

لإنشاء حدث جديد يستمر طوال اليوم ويمكن أن يمتد لعدّة أيام.

// Creates an all-day event for the Woodstock festival (August 15th to 17th) and logs the ID.
var 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());

المعلمات

المعلمات المتقدمة

الإرجاع

CalendarEvent — الحدث الذي تم إنشاؤه

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

• https://www.googleapis.com/auth/calendar
• https://www.google.com/calendar/feeds

ينشئ حدثًا جديدًا على مدار اليوم.

// Creates an all-day event for the moon landing and logs the ID.
var event = CalendarApp.getDefaultCalendar().createAllDayEvent('Apollo 11 Landing',
    new Date('July 20, 1969'),
    {location: 'The Moon'});
Logger.log('Event ID: ' + event.getId());

المعلمات

المعلمات المتقدمة

الإرجاع

CalendarEvent — الحدث الذي تم إنشاؤه

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

• https://www.googleapis.com/auth/calendar
• https://www.google.com/calendar/feeds

إنشاء سلسلة أحداث جديدة على مدار اليوم

// Creates an event series for a no-meetings day, taking place every Wednesday in 2013.
var 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());

المعلمات

الإرجاع

CalendarEventSeries — سلسلة الأحداث التي تم إنشاؤها

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

• https://www.googleapis.com/auth/calendar
• https://www.google.com/calendar/feeds

إنشاء سلسلة أحداث جديدة على مدار اليوم

// Creates an event series for a no-meetings day, taking place every Wednesday in 2013.
var 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());

المعلمات

المعلمات المتقدمة

الإرجاع

CalendarEventSeries — سلسلة الأحداث التي تم إنشاؤها

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

• https://www.googleapis.com/auth/calendar
• https://www.google.com/calendar/feeds

ينشئ تقويمًا جديدًا يملكه المستخدم.

// Creates a new calendar named "Travel Plans".
var calendar = CalendarApp.createCalendar('Travel Plans');
Logger.log('Created the calendar "%s", with the ID "%s".',
    calendar.getName(), calendar.getId());

المعلمات

الإرجاع

Calendar: التقويم الذي تم إنشاؤه حديثًا

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

• https://www.googleapis.com/auth/calendar
• https://www.google.com/calendar/feeds

ينشئ تقويمًا جديدًا يملكه المستخدم.

// Creates a new calendar named "Travel Plans" with a summary and color.
var calendar = CalendarApp.createCalendar('Travel Plans', {
  summary: '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());

المعلمات

المعلمات المتقدمة

الإرجاع

Calendar: التقويم الذي تم إنشاؤه حديثًا

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

• https://www.googleapis.com/auth/calendar
• https://www.google.com/calendar/feeds

ينشئ حدثًا جديدًا.

إذا لم يتم تحديد أي منطقة زمنية، فسيتم تفسير قيم الوقت في سياق تشغيل النص البرمجي المنطقة الزمنية، والتي قد تختلف عن المنطقة الزمنية للتقويم.

// Creates an event for the moon landing and logs the ID.
var 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());

المعلمات

الإرجاع

CalendarEvent — الحدث الذي تم إنشاؤه

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

• https://www.googleapis.com/auth/calendar
• https://www.google.com/calendar/feeds

ينشئ حدثًا جديدًا.

إذا لم يتم تحديد أي منطقة زمنية، فسيتم تفسير قيم الوقت في سياق تشغيل النص البرمجي المنطقة الزمنية، والتي قد تختلف عن المنطقة الزمنية للتقويم.

// Creates an event for the moon landing and logs the ID.
var 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());

المعلمات

المعلمات المتقدمة

الإرجاع

CalendarEvent — الحدث الذي تم إنشاؤه

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

• https://www.googleapis.com/auth/calendar
• https://www.google.com/calendar/feeds

تنشئ حدثًا من وصف بتصميم مرن.

يجب أن يستخدم الوصف التنسيق نفسه الذي تستخدمه ميزة "الإضافة السريعة" في واجهة المستخدم.

// Creates a new event and logs its ID.
var event = CalendarApp.getDefaultCalendar()
    .createEventFromDescription('Lunch with Mary, Friday at 1PM');
Logger.log('Event ID: ' + event.getId());

المعلمات

الإرجاع

CalendarEvent — الحدث الذي تم إنشاؤه

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

• https://www.googleapis.com/auth/calendar
• https://www.google.com/calendar/feeds

يؤدي هذا الخيار إلى إنشاء سلسلة أحداث جديدة.

// Creates an event series for a team meeting, taking place every Tuesday and Thursday in 2013.
var 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());

المعلمات

الإرجاع

CalendarEventSeries — سلسلة الأحداث التي تم إنشاؤها

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

• https://www.googleapis.com/auth/calendar
• https://www.google.com/calendar/feeds

يؤدي هذا الخيار إلى إنشاء سلسلة أحداث جديدة.

// Creates an event series for a team meeting, taking place every Tuesday and Thursday in 2013.
var 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());

المعلمات

المعلمات المتقدمة

الإرجاع

CalendarEventSeries — سلسلة الأحداث التي تم إنشاؤها

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

• https://www.googleapis.com/auth/calendar
• https://www.google.com/calendar/feeds

الحصول على جميع التقاويم التي يملكها المستخدم أو يشترك فيها

// Determines how many calendars the user can access.
var 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

الحصول على جميع التقاويم التي يملكها المستخدم

// Determines how many calendars the user owns.
var 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

يمكن جلب التقويم مع المعرّف المقدم.

// Gets the public calendar "US Holidays" by ID.
var calendar = CalendarApp.getCalendarById(
    'en.usa#holiday@group.v.calendar.google.com');
Logger.log('The calendar is named "%s".', calendar.getName());

المعلمات

الإرجاع

Calendar — التقويم الذي يحمل المعرّف المحدد، أو null إذا لم يكن التقويم موجودًا، إذا كان لا يمكن للمستخدم الوصول إليه، أو إذا لم يكن المستخدم مشتركًا في التقويم

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

• https://www.googleapis.com/auth/calendar
• https://www.googleapis.com/auth/calendar.readonly
• https://www.google.com/calendar/feeds

جلب جميع التقاويم باسم معين يمتلكه المستخدم أو يشترك فيه. الأسماء ليست حساسة لحالة الأحرف.

// Gets the public calendar named "US Holidays".
var calendars = CalendarApp.getCalendarsByName('US Holidays');
Logger.log('Found %s matching calendars.', calendars.length);

المعلمات

الإرجاع

Calendar[] - جميع التقاويم التي تحمل هذا الاسم والتي يمكن للمستخدم الوصول إليها

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

• https://www.googleapis.com/auth/calendar
• https://www.googleapis.com/auth/calendar.readonly
• https://www.google.com/calendar/feeds

الحصول على لون التقويم

// 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

الحصول على التقويم التلقائي للمستخدم

// Determines the time zone of the user's default calendar.
var 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

يحصل على وصف التقويم.

// 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

الحصول على الحدث بالمعرّف المحدّد. إذا كانت السلسلة تابعة لتقويم غير التقويم التلقائي التقويم، فيجب استدعاء هذه الطريقة من هذا التقويم. الاتصال بالرقم getEventById(iCalId) فقط تؤدي إلى إرجاع حدث في التقويم الافتراضي.

قد يكون لأحداث متعددة رقم التعريف نفسه إذا كانت جزءًا من سلسلة أحداث. في هذه الحالة، تُرجع الطريقة الأولى فقط الحدث الأول من تلك السلسلة.

// 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());

المعلمات

الإرجاع

CalendarEvent — الحدث ذو رقم التعريف المحدّد، أو null إذا لم يكن موجودًا أو إذا كان المستخدم لا يمكنه الوصول إليه.

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

• https://www.googleapis.com/auth/calendar
• https://www.googleapis.com/auth/calendar.readonly
• https://www.google.com/calendar/feeds

الحصول على سلسلة الأحداث برقم التعريف المحدّد. وإذا كان المعرّف المقدَّم خاصًا بـ CalendarEvent واحد، ثم يتم عرض CalendarEventSeries مع حدث واحد في السلسلة. لاحظ أنه إذا تنتمي سلسلة الأحداث إلى تقويم غير التقويم الافتراضي، يجب أن تكون هذه الطريقة استدعيت من هذا CalendarApp؛ جارٍ الاتصال بالرقم getEventSeriesById(iCalId) مباشرةً فقط سلسلة أحداث موجودة في التقويم التلقائي

// 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());

المعلمات

الإرجاع

CalendarEventSeries — السلسلة التي تتضمن رقم التعريف المحدّد، أو null إذا لم تكن السلسلة متوفرة أو إذا كان المستخدم لا يمكنه الوصول إليه.

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

• https://www.googleapis.com/auth/calendar
• https://www.googleapis.com/auth/calendar.readonly
• https://www.google.com/calendar/feeds

الحصول على جميع الأحداث التي تقع خلال نطاق زمني معيّن.

تعرض هذه الطريقة الأحداث التي تبدأ خلال النطاق الزمني المحدَّد وتنتهي خلال الوقت النطاق أو تضم النطاق الزمني. إذا لم يتم تحديد أي منطقة زمنية، يتم ضبط قيم الوقت يتم تفسيرها في سياق المنطقة الزمنية للنص البرمجي، والتي قد تختلف عن المنطقة الزمنية للتقويم.

// Determines how many events are happening in the next two hours.
var now = new Date();
var twoHoursFromNow = new Date(now.getTime() + (2 * 60 * 60 * 1000));
var events = CalendarApp.getDefaultCalendar().getEvents(now, twoHoursFromNow);
Logger.log('Number of events: ' + events.length);

المعلمات

الإرجاع

CalendarEvent[] - الأحداث التي تقع ضمن النطاق الزمني

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

• https://www.googleapis.com/auth/calendar
• https://www.googleapis.com/auth/calendar.readonly
• https://www.google.com/calendar/feeds

تجمع جميع الأحداث التي تقع خلال نطاق زمني معيّن وتفي بالمعايير المحددة.

تعرض هذه الطريقة الأحداث التي تبدأ خلال النطاق الزمني المحدَّد وتنتهي خلال الوقت النطاق أو يضم النطاق الزمني. إذا لم يتم تحديد أي منطقة زمنية، يتم ضبط قيم الوقت يتم تفسيرها في سياق المنطقة الزمنية للنص البرمجي، والتي قد تختلف عن المنطقة الزمنية للتقويم.

يُرجى العلم أنّ الفلترة في author أو search أو statusFilters تستغرق بعد تطبيق start وmax. وهذا يعني أن عدد الأحداث التي يتم عرضها أقل من max، على الرغم من استيفاء الأحداث الإضافية للمعايير.

// Determines how many events are happening in the next two hours that contain the term
// "meeting".
var now = new Date();
var twoHoursFromNow = new Date(now.getTime() + (2 * 60 * 60 * 1000));
var events = CalendarApp.getDefaultCalendar().getEvents(now, twoHoursFromNow,
    {search: 'meeting'});
Logger.log('Number of events: ' + events.length);

المعلمات

المعلمات المتقدمة

الإرجاع

CalendarEvent[] — الأحداث التي تقع خلال النطاق الزمني وتتطابق مع المعايير

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

• https://www.googleapis.com/auth/calendar
• https://www.googleapis.com/auth/calendar.readonly
• https://www.google.com/calendar/feeds

الحصول على جميع الأحداث التي تقع في يوم معين.

تعرض هذه الطريقة الأحداث إذا كانت تبدأ خلال يوم معين أو انتهت خلال اليوم أو تضمين اليوم.

تجدر الإشارة إلى أنه يتم استخدام جزء التاريخ فقط من عنصر "التاريخ"، ويتم تجاهل جزء الوقت. يتم تفسير التاريخ على أنه منتصف الليل في ذلك اليوم إلى منتصف ليل اليوم التالي في وقت التقويم المنطقة.

// Determines how many events are happening today.
var today = new Date();
var events = CalendarApp.getDefaultCalendar().getEventsForDay(today);
Logger.log('Number of events: ' + events.length);

المعلمات

الإرجاع

CalendarEvent[] - الأحداث التي تقع في التاريخ المحدّد

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

• https://www.googleapis.com/auth/calendar
• https://www.googleapis.com/auth/calendar.readonly
• https://www.google.com/calendar/feeds

الحصول على جميع الأحداث التي تقع في يوم معين واستيفاء معايير محددة.

تعرض هذه الطريقة الأحداث إذا كانت تبدأ خلال يوم معين أو انتهت خلال اليوم أو تضمين اليوم.

تجدر الإشارة إلى أنه يتم استخدام جزء التاريخ فقط من عنصر "التاريخ"، ويتم تجاهل جزء الوقت. يتم تفسير التاريخ على أنه منتصف الليل في ذلك اليوم إلى منتصف ليل اليوم التالي في وقت التقويم المنطقة.

يُرجى العلم أنّ الفلترة في author أو search أو statusFilters تستغرق بعد تطبيق start وmax. وهذا يعني أن عدد الأحداث التي يتم عرضها أقل من max، على الرغم من استيفاء الأحداث الإضافية للمعايير.

// Determines how many events are happening today and contain the term "meeting".
var today = new Date();
var events = CalendarApp.getDefaultCalendar().getEventsForDay(today, {search: 'meeting'});
Logger.log('Number of events: ' + events.length);

المعلمات

المعلمات المتقدمة

الإرجاع

CalendarEvent[] - الأحداث التي تقع في التاريخ المحدّد وتتطابق مع المعايير

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

• https://www.googleapis.com/auth/calendar
• https://www.googleapis.com/auth/calendar.readonly
• https://www.google.com/calendar/feeds

الحصول على رقم تعريف التقويم رقم تعريف التقويم التلقائي للمستخدم هو عنوان بريده الإلكتروني.

// 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

الحصول على اسم التقويم

// 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

الحصول على التقويم مع رقم التعريف المحدد، إذا كان المستخدم يمتلكه.

للعثور على معرِّف التقويم، انقر على السهم المجاور لاسم التقويم في تقويم Google اختَر إعدادات التقويم. يظهر رقم التعريف بالقرب من أسفل الإعدادات. .

// Gets a (non-existent) private calendar by ID.
var calendar = CalendarApp.getOwnedCalendarById(
    '123456789@group.calendar.google.com');
Logger.log('The calendar is named "%s".', calendar.getName());

المعلمات

الإرجاع

Calendar — التقويم الذي يحمل المعرّف المحدد، أو null إذا لم يكن التقويم موجودًا أو لا يمتلكه المستخدم

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

• https://www.googleapis.com/auth/calendar
• https://www.googleapis.com/auth/calendar.readonly
• https://www.google.com/calendar/feeds

جلب جميع التقاويم باسم معين يملكه المستخدم. الأسماء ليست حسّاسة لحالة الأحرف.

// Gets a private calendar named "Travel Plans".
var calendars = CalendarApp.getOwnedCalendarsByName('Travel Plans');
Logger.log('Found %s matching calendars.', calendars.length);

المعلمات

الإرجاع

Calendar[] - جميع التقاويم التي تحمل هذا الاسم الذي يمتلكه المستخدم

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

• https://www.googleapis.com/auth/calendar
• https://www.googleapis.com/auth/calendar.readonly
• https://www.google.com/calendar/feeds

الحصول على المنطقة الزمنية للتقويم

// 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 — المنطقة الزمنية المحددة بالصيغة "long" (على سبيل المثال، "America/New_York"، كما هو مذكور بواسطة Joda.org).

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

• https://www.googleapis.com/auth/calendar
• https://www.googleapis.com/auth/calendar.readonly
• https://www.google.com/calendar/feeds

تحدِّد هذه السياسة ما إذا كان التقويم مخفيًا في واجهة المستخدم.

// 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

يحدِّد هذا الإعداد ما إذا كان التقويم هو التقويم الأساسي للمستخدم الفعال.

// 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

يحدد ما إذا كنت تمتلك التقويم أم لا.

// 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

تحدِّد هذه السياسة ما إذا كان سيتم عرض أحداث التقويم في واجهة المستخدم.

// 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

تنشئ كائن تكرار جديدًا، يمكن استخدامه لإنشاء قواعد لتكرار الحدث.

// Creates an event series for a no-meetings day, taking place every Wednesday in 2013.
var recurrence = CalendarApp.newRecurrence().addWeeklyRule()
    .onlyOnWeekday(CalendarApp.Weekday.WEDNESDAY)
    .until(new Date('January 1, 2014'));
var eventSeries = CalendarApp.getDefaultCalendar().createAllDayEventSeries('No Meetings',
    new Date('January 2, 2013 03:00:00 PM EST'),
    recurrence);
Logger.log('Event Series ID: ' + eventSeries.getId());

الإرجاع

EventRecurrence — كائن تكرار جديد لم يتم تعيين قواعد له (يتصرف كتكرار أسبوعي)

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

• https://www.googleapis.com/auth/calendar
• https://www.googleapis.com/auth/calendar.readonly
• https://www.google.com/calendar/feeds

لضبط لون التقويم.

// 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);

المعلمات

الإرجاع

Calendar — هذا التقويم للسلسلة.

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

• https://www.googleapis.com/auth/calendar
• https://www.google.com/calendar/feeds

لضبط وصف التقويم.

// 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.')

المعلمات

الإرجاع

Calendar — هذا التقويم للسلسلة

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

• https://www.googleapis.com/auth/calendar
• https://www.google.com/calendar/feeds

تحدِّد هذه السياسة ما إذا كان التقويم مرئيًا في واجهة المستخدم.

المعلمات

الإرجاع

Calendar — هذا التقويم للسلسلة

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

• https://www.googleapis.com/auth/calendar
• https://www.google.com/calendar/feeds

لضبط اسم التقويم.

// 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');

المعلمات

الإرجاع

Calendar — هذا التقويم للسلسلة

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

• https://www.googleapis.com/auth/calendar
• https://www.google.com/calendar/feeds

تحدِّد هذه السياسة ما إذا كان سيتم عرض أحداث التقويم في واجهة المستخدم.

// 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);

المعلمات

الإرجاع

Calendar — هذا التقويم للسلسلة

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

• https://www.googleapis.com/auth/calendar
• https://www.google.com/calendar/feeds

لضبط المنطقة الزمنية للتقويم.

// 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');

المعلمات

الإرجاع

Calendar — هذا التقويم للسلسلة.

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

• https://www.googleapis.com/auth/calendar
• https://www.google.com/calendar/feeds

تتيح هذه الميزة للمستخدم الاشتراك في التقويم باستخدام المعرّف المحدّد، إذا كان مسموحًا للمستخدم بالاشتراك.

// Subscribe to the calendar "US Holidays".
var calendar = CalendarApp.subscribeToCalendar(
    'en.usa#holiday@group.v.calendar.google.com');
Logger.log('Subscribed to the calendar "%s".', calendar.getName());

المعلمات

الإرجاع

Calendar — المستخدم الذي تم الاشتراك فيه حديثًا في التقويم

الرميات

Error: في حال عدم توفّر تقويم يحمل رقم التعريف هذا

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

• https://www.googleapis.com/auth/calendar
• https://www.google.com/calendar/feeds

تتيح هذه الميزة للمستخدم الاشتراك في التقويم باستخدام المعرّف المحدّد، إذا كان مسموحًا للمستخدم بالاشتراك.

// Subscribe to the calendar "US Holidays", and set it to the color blue.
var calendar = CalendarApp.subscribeToCalendar(
    'en.usa#holiday@group.v.calendar.google.com',
    { color: CalendarApp.Color.BLUE });
Logger.log('Subscribed to the calendar "%s".', calendar.getName());

المعلمات

المعلمات المتقدمة

الإرجاع

Calendar — التقويم الذي تم الاشتراك فيه حديثًا

الرميات

Error: في حال عدم توفّر تقويم يحمل رقم التعريف هذا

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

• https://www.googleapis.com/auth/calendar
• https://www.google.com/calendar/feeds