يمثل هذا الإعداد إعدادات التكرار لسلسلة أحداث.
الطُرق
الطريقة | نوع الإرجاع | وصف قصير |
---|---|---|
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
: قاعدة 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
: قاعدة RecurrenceRule الجديدة
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
addDate(date)
إضافة قاعدة تؤدي إلى تكرار الحدث في تاريخ محدد
المعلمات
الاسم | النوع | الوصف |
---|---|---|
date | Date |
الإرجاع
EventRecurrence
— حدث EventRecurrence هذا للتسلسل
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
addDateExclusion(date)
إضافة قاعدة تستبعد ورودًا لتاريخ محدد.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
date | Date |
الإرجاع
EventRecurrence
— حدث EventRecurrence هذا للتسلسل
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
addMonthlyExclusion()
إضافة قاعدة تستبعد التكرارات على أساس شهري.
يتم تطبيق الاستثناء تلقائيًا في اليوم نفسه من الشهر الذي يقع فيه الحدث الأول في
ولكن يمكن تغيير ذلك من خلال طلب الرقم RecurrenceRule.onlyOnMonthDay(day)
أو RecurrenceRule.onlyOnMonthDays(days)
.
الإرجاع
RecurrenceRule
: قاعدة 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
: قاعدة 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
: قاعدة 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
: قاعدة RecurrenceRule الجديدة
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
addYearlyExclusion()
تضيف قاعدة تستبعد مواضع الورود سنويًا.
يتم تطبيق الاستثناء تلقائيًا في اليوم نفسه من العام الذي يقع فيه الحدث الأول في
ولكن يمكن تغيير ذلك من خلال طلب الرقم RecurrenceRule.onlyOnYearDay(day)
أو RecurrenceRule.onlyOnYearDays(days)
.
الإرجاع
RecurrenceRule
: قاعدة RecurrenceRule الجديدة
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
addYearlyRule()
تضيف قاعدة تؤدي إلى تكرار الحدث على أساس سنوي.
بشكل افتراضي، يتكرر الحدث في اليوم نفسه من السنة الذي يقع فيه الحدث الأول في السلسلة،
ولكن يمكن تغيير ذلك من خلال طلب الرقم RecurrenceRule.onlyOnYearDay(day)
أو RecurrenceRule.onlyOnYearDays(days)
.
الإرجاع
RecurrenceRule
: قاعدة RecurrenceRule الجديدة
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
setTimeZone(timeZone)
يتم تعيين المنطقة الزمنية لهذا التكرار. يؤثر هذا في تاريخ ووقت تكرار الأحداث وما إذا كان الحدث يتغير مع التوقيت الصيفي. يتم ضبط القيمة التلقائية على المنطقة الزمنية للتقويم.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
timeZone | String | المنطقة الزمنية، محددة بالتنسيق "طويل" (مثلاً، "America/New_York"، كما هو مُدرَج بواسطة Joda.org) |
الإرجاع
EventRecurrence
— حدث EventRecurrence هذا للتسلسل
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds