Class 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 - قاعدة التكرار الجديدة

التفويض

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

  • 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 - قاعدة التكرار الجديدة

التفويض

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

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

addDate(date)

تُضيف قاعدة تؤدي إلى تكرار الحدث في تاريخ محدّد.

المعلمات

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

الإرجاع

‫EventRecurrence — هذا العنصر EventRecurrence لإنشاء سلسلة

التفويض

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

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

addDateExclusion(date)

تُضيف قاعدة تستبعد مرّة حدوث لتاريخ محدّد.

المعلمات

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

الإرجاع

‫EventRecurrence — هذا العنصر EventRecurrence لإنشاء سلسلة

التفويض

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

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

addMonthlyExclusion()

تُضيف قاعدة تستبعد تكرار الحدث شهريًا.

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

الإرجاع

‫RecurrenceRule - قاعدة التكرار الجديدة

التفويض

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

  • 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 - قاعدة التكرار الجديدة

التفويض

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

  • 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 - قاعدة التكرار الجديدة

التفويض

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

  • 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 - قاعدة التكرار الجديدة

التفويض

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

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

addYearlyExclusion()

تُضيف قاعدة تستبعد الأحداث على أساس سنوي.

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

الإرجاع

‫RecurrenceRule - قاعدة التكرار الجديدة

التفويض

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

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

addYearlyRule()

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

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

الإرجاع

‫RecurrenceRule - قاعدة التكرار الجديدة

التفويض

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

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

setTimeZone(timeZone)

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

المعلمات

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

الإرجاع

‫EventRecurrence — هذا العنصر EventRecurrence لإنشاء سلسلة

التفويض

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

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