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.
var 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.
var recurrence = CalendarApp.newRecurrence().addDailyRule().times(10);

استرجاع الكرة

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

التفويض

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

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

addDate(date)

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

المَعلمات

الاسمTypeالوصف
dateDate

استرجاع الكرة

EventRecurrence — تكرار الحدث هذا للتسلسل

التفويض

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

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

addDateExclusion(date)

لإضافة قاعدة تستثني حدثًا لتاريخ محدَّد.

المَعلمات

الاسمTypeالوصف
dateDate

استرجاع الكرة

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.
var 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.
var 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.
var 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)

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

المَعلمات

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

استرجاع الكرة

EventRecurrence — تكرار الحدث هذا للتسلسل

التفويض

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

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