Class EventRecurrence

EventRecurrence

تمثّل إعدادات التكرار لسلسلة أحداث.

الطُرق

الطريقةنوع القيمة التي تم إرجاعهاوصف قصير
addDailyExclusion()RecurrenceRuleتضيف هذه السمة قاعدة تستبعد التكرارات على أساس يومي.
addDailyRule()RecurrenceRuleتضيف هذه السمة قاعدة تؤدي إلى تكرار الحدث يوميًا.
addDate(date)EventRecurrenceتضيف هذه السمة قاعدة تجعل الحدث يتكرّر في تاريخ محدّد.
addDateExclusion(date)EventRecurrenceتضيف هذه السمة قاعدة تستبعد تكرارًا لتاريخ معيّن.
addMonthlyExclusion()RecurrenceRuleتضيف هذه السمة قاعدة تستبعد التكرارات على أساس شهري.
addMonthlyRule()RecurrenceRuleتضيف هذه السمة قاعدة تؤدي إلى تكرار الحدث شهريًا.
addWeeklyExclusion()RecurrenceRuleتضيف هذه السمة قاعدة تستبعد التكرارات على أساس أسبوعي.
addWeeklyRule()RecurrenceRuleتضيف هذه السمة قاعدة تؤدي إلى تكرار الحدث أسبوعيًا.
addYearlyExclusion()RecurrenceRuleتضيف هذه السمة قاعدة تستبعد التكرارات على أساس سنوي.
addYearlyRule()RecurrenceRuleتضيف هذه السمة قاعدة تؤدي إلى تكرار الحدث سنويًا.
setTimeZone(timeZone)EventRecurrenceتضبط هذه السمة المنطقة الزمنية لهذا التكرار.

مستندات تفصيلية

addDailyExclusion()

تضيف هذه السمة قاعدة تستبعد التكرارات على أساس يومي. 

// Creates a rule that recurs every week after the first 30 days.
const recurrence =
    CalendarApp.newRecurrence().addWeeklyRule().addDailyExclusion().times(30);

الإرجاع

‫RecurrenceRule — RecurrenceRule الجديد

التفويض

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

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

addDailyRule()

تضيف هذه السمة قاعدة تؤدي إلى تكرار الحدث يوميًا. 

// Creates a rule that recurs every day for ten days.
const recurrence = CalendarApp.newRecurrence().addDailyRule().times(10);

الإرجاع

‫RecurrenceRule — RecurrenceRule الجديد

التفويض

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

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

addDate(date)

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

المَعلمات

الاسمالنوعالوصف
dateDate

الإرجاع

‫EventRecurrence — EventRecurrence هذا للسلسلة

التفويض

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

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

addDateExclusion(date)

تضيف هذه السمة قاعدة تستبعد تكرارًا لتاريخ معيّن.

المَعلمات

الاسمالنوعالوصف
dateDate

الإرجاع

‫EventRecurrence — EventRecurrence هذا للسلسلة

التفويض

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

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

addMonthlyExclusion()

تضيف هذه السمة قاعدة تستبعد التكرارات على أساس شهري.

يتم تطبيق الاستثناء تلقائيًا في اليوم نفسه من الشهر الذي يقع فيه الحدث الأول في السلسلة، ولكن يمكن تغيير ذلك من خلال استدعاء RecurrenceRule.onlyOnMonthDay(day) أو RecurrenceRule.onlyOnMonthDays(days).

الإرجاع

‫RecurrenceRule — RecurrenceRule الجديد

التفويض

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

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

addMonthlyRule()

تضيف هذه السمة قاعدة تؤدي إلى تكرار الحدث شهريًا.

يتكرّر الحدث تلقائيًا في اليوم نفسه من الشهر الذي يقع فيه الحدث الأول في السلسلة، ولكن يمكن تغيير ذلك من خلال استدعاء RecurrenceRule.onlyOnMonthDay(day) أو RecurrenceRule.onlyOnMonthDays(days). 

// Creates a rule that recurs every month for three months.
const recurrence = CalendarApp.newRecurrence().addMonthlyRule().times(4);

الإرجاع

‫RecurrenceRule — RecurrenceRule الجديد

التفويض

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

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

addWeeklyExclusion()

تضيف هذه السمة قاعدة تستبعد التكرارات على أساس أسبوعي.

يتم تطبيق الاستثناء تلقائيًا في اليوم نفسه من الأسبوع الذي يقع فيه الحدث الأول في السلسلة، ولكن يمكن تغيير ذلك من خلال استدعاء RecurrenceRule.onlyOnWeekday(day) أو RecurrenceRule.onlyOnWeekdays(days). 

// Creates a rule that recurs every day except the first four Wednesdays.
const recurrence = CalendarApp.newRecurrence()
                       .addDailyRule()
                       .addWeeklyExclusion()
                       .onlyOnWeekday(CalendarApp.Weekday.WEDNESDAY)
                       .times(4);

الإرجاع

‫RecurrenceRule — RecurrenceRule الجديد

التفويض

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

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

addWeeklyRule()

تضيف هذه السمة قاعدة تؤدي إلى تكرار الحدث أسبوعيًا.

يتكرّر الحدث تلقائيًا في اليوم نفسه من الأسبوع الذي يقع فيه الحدث الأول في السلسلة، ولكن يمكن تغيير ذلك من خلال استدعاء RecurrenceRule.onlyOnWeekday(day) أو RecurrenceRule.onlyOnWeekdays(days). 

// Creates a rule that recurs every week for ten weeks.
const recurrence = CalendarApp.newRecurrence().addWeeklyRule().times(10);

الإرجاع

‫RecurrenceRule — RecurrenceRule الجديد

التفويض

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

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

addYearlyExclusion()

تضيف هذه السمة قاعدة تستبعد التكرارات على أساس سنوي.

يتم تطبيق الاستثناء تلقائيًا في اليوم نفسه من السنة الذي يقع فيه الحدث الأول في السلسلة، ولكن يمكن تغيير ذلك من خلال استدعاء RecurrenceRule.onlyOnYearDay(day) أو RecurrenceRule.onlyOnYearDays(days).

الإرجاع

‫RecurrenceRule — RecurrenceRule الجديد

التفويض

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

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

addYearlyRule()

تضيف هذه السمة قاعدة تؤدي إلى تكرار الحدث سنويًا.

يتكرّر الحدث تلقائيًا في اليوم نفسه من السنة الذي وقع فيه الحدث الأول في السلسلة، ولكن يمكن تغيير ذلك من خلال استدعاء RecurrenceRule.onlyOnYearDay(day) أو RecurrenceRule.onlyOnYearDays(days).

الإرجاع

‫RecurrenceRule — RecurrenceRule الجديد

التفويض

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

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

setTimeZone(timeZone)

تضبط هذه السمة المنطقة الزمنية لهذا التكرار. يؤثر ذلك في تاريخ ووقت تكرار الأحداث، وما إذا كان الحدث يتغيّر مع التوقيت الصيفي. يتم ضبطها تلقائيًا على المنطقة الزمنية للتقويم.

المَعلمات

الاسمالنوعالوصف
timeZoneStringالمنطقة الزمنية، المحدّدة بالتنسيق "الطويل" (على سبيل المثال، America/New_York، كما هو مدرَج في Joda.org)

الإرجاع

‫EventRecurrence — EventRecurrence هذا للسلسلة

التفويض

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

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