عرض تقديمي.
الطُرق
الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
---|---|---|
addEditor(emailAddress) | Presentation | لإضافة المستخدم المحدّد إلى قائمة المحرِّرين في Presentation . |
addEditor(user) | Presentation | لإضافة المستخدم المحدّد إلى قائمة المحرِّرين في Presentation . |
addEditors(emailAddresses) | Presentation | لإضافة مجموعة المستخدمين المحدّدة إلى قائمة المحرِّرين في Presentation . |
addViewer(emailAddress) | Presentation | لإضافة المستخدم المحدّد إلى قائمة المشاهدين في Presentation . |
addViewer(user) | Presentation | لإضافة المستخدم المحدّد إلى قائمة المشاهدين في Presentation . |
addViewers(emailAddresses) | Presentation | لإضافة مصفوفة المستخدمين المحددة إلى قائمة العارضين لـ Presentation . |
appendSlide() | Slide | لإلحاق شريحة بنهاية العرض التقديمي باستخدام التنسيق PredefinedLayout.BLANK المحدّد مسبقًا استنادًا إلى الشريحة الرئيسية الحالية. |
appendSlide(layout) | Slide | لإلحاق شريحة بنهاية العرض التقديمي باستخدام التخطيط المحدد بناءً على الشريحة الرئيسية الحالية. |
appendSlide(predefinedLayout) | Slide | ترفق شريحة بنهاية العرض التقديمي باستخدام التخطيط المحدد مسبقًا بناءً على الشريحة الرئيسية الحالية. |
appendSlide(slide) | Slide | لإلحاق نسخة من Slide المقدَّمة بنهاية العرض التقديمي. |
appendSlide(slide, linkingMode) | Slide | لإلحاق نسخة من Slide المقدَّمة من العرض التقديمي المصدر إلى نهاية
العرض التقديمي الحالي، وضبط رابط الشريحة على النحو المحدّد في SlideLinkingMode . |
getEditors() | User[] | يمكنك الحصول على قائمة بالمحرِّرين في Presentation . |
getId() | String | الحصول على المعرّف الفريد للعرض التقديمي |
getLayouts() | Layout[] | الحصول على التنسيقات في العرض التقديمي |
getMasters() | Master[] | الحصول على الخبراء في العرض التقديمي. |
getName() | String | الحصول على اسم العرض التقديمي أو عنوانه |
getNotesMaster() | NotesMaster | الحصول على الملاحظات الرئيسية للعرض التقديمي. |
getNotesPageHeight() | Number | للحصول على ارتفاع صفحة الملاحظات الرئيسية وصفحات الملاحظات في العرض التقديمي بالنقاط. |
getNotesPageWidth() | Number | للحصول على عرض صفحة الملاحظات الرئيسية وصفحات الملاحظات في العرض التقديمي بالنقاط. |
getPageElementById(id) | PageElement | لعرض PageElement بالمعرّف المحدّد، أو عرض null في حال عدم توفّره. |
getPageHeight() | Number | الحصول على ارتفاع صفحة الشرائح والتنسيقات والعروض الرئيسية في العرض التقديمي بالنقاط. |
getPageWidth() | Number | للحصول على عرض الصفحة للشرائح والتنسيقات والشرائح الرئيسية في العرض التقديمي بالنقاط. |
getSelection() | Selection | لعرض اختيار المستخدم في العرض التقديمي النشط |
getSlideById(id) | Slide | لعرض Slide بالمعرّف المحدّد، أو عرض null في حال عدم توفّره. |
getSlides() | Slide[] | الحصول على الشرائح في العرض التقديمي. |
getUrl() | String | استرداد عنوان URL للوصول إلى هذا العرض التقديمي. |
getViewers() | User[] | للحصول على قائمة المشاهدين والمعلقين على Presentation هذا. |
insertSlide(insertionIndex) | Slide | يدرج شريحة في الفهرس المحدد في العرض التقديمي باستخدام تنسيق PredefinedLayout.BLANK المحدد مسبقًا استنادًا إلى الشريحة الرئيسية الحالية. |
insertSlide(insertionIndex, layout) | Slide | يدرج شريحة في الفهرس المحدد في العرض التقديمي باستخدام التنسيق المحدد بناءً على الشريحة الرئيسية الحالية. |
insertSlide(insertionIndex, predefinedLayout) | Slide | يدرج شريحة في الفهرس المحدد في العرض التقديمي باستخدام التخطيط المحدد مسبقًا استنادًا إلى الشريحة الرئيسية الحالية. |
insertSlide(insertionIndex, slide) | Slide | يدرج نسخة من Slide المتوفرة في الفهرس المحدد في العرض التقديمي. |
insertSlide(insertionIndex, slide, linkingMode) | Slide | يدرج نسخة من Slide المقدَّمة من العرض التقديمي المصدر في الفهرس المحدّد في العرض التقديمي الحالي، ويضبط رابط الشريحة على النحو المحدّد في SlideLinkingMode . |
removeEditor(emailAddress) | Presentation | لإزالة المستخدم المحدّد من قائمة المحرِّرين في Presentation . |
removeEditor(user) | Presentation | لإزالة المستخدم المحدّد من قائمة المحرِّرين في Presentation . |
removeViewer(emailAddress) | Presentation | لإزالة المستخدم المحدّد من قائمة المشاهدين والمعلقين في Presentation . |
removeViewer(user) | Presentation | لإزالة المستخدم المحدّد من قائمة المشاهدين والمعلقين في Presentation . |
replaceAllText(findText, replaceText) | Integer | لاستبدال جميع تكرارات النص المطابق للبحث عن النص باستبدال النص. |
replaceAllText(findText, replaceText, matchCase) | Integer | لاستبدال جميع تكرارات النص المطابق للبحث عن النص باستبدال النص. |
saveAndClose() | void | حفظ Presentation الحالية |
setName(name) | void | تحدِّد هذه السياسة اسم العرض التقديمي أو عنوانه. |
الوثائق التفصيلية
addEditor(emailAddress)
لإضافة المستخدم المحدّد إلى قائمة المحرِّرين في Presentation
. إذا كان المستخدم مدرجًا في قائمة المشاهدين، تؤدي هذه الطريقة إلى إزالة المستخدم من قائمة المشاهدين.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
emailAddress | String | عنوان البريد الإلكتروني للمستخدم المطلوب إضافته. |
استرجاع الكرة
Presentation
- جهاز Presentation
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
addEditor(user)
لإضافة المستخدم المحدّد إلى قائمة المحرِّرين في Presentation
. إذا كان المستخدم مدرجًا في قائمة المشاهدين، تؤدي هذه الطريقة إلى إزالة المستخدم من قائمة المشاهدين.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
user | User | تمثيل للمستخدم تتم إضافته. |
استرجاع الكرة
Presentation
- جهاز Presentation
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
addEditors(emailAddresses)
لإضافة مجموعة المستخدمين المحدّدة إلى قائمة المحرِّرين في Presentation
. إذا كان أيٌّ من المستخدمين مدرجًا في قائمة المشاهدين، تعمل هذه الطريقة على الترويج له خارج قائمة المشاهدين.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
emailAddresses | String[] | مصفوفة من عناوين البريد الإلكتروني للمستخدمين المراد إضافتها. |
استرجاع الكرة
Presentation
- جهاز Presentation
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
addViewer(emailAddress)
لإضافة المستخدم المحدّد إلى قائمة المشاهدين في Presentation
. إذا كان المستخدم بالفعل في قائمة
المحررين، فلن يكون لهذه الطريقة أي تأثير.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
emailAddress | String | عنوان البريد الإلكتروني للمستخدم المطلوب إضافته. |
استرجاع الكرة
Presentation
- جهاز Presentation
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
addViewer(user)
لإضافة المستخدم المحدّد إلى قائمة المشاهدين في Presentation
. إذا كان المستخدم بالفعل في قائمة
المحررين، فلن يكون لهذه الطريقة أي تأثير.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
user | User | تمثيل للمستخدم تتم إضافته. |
استرجاع الكرة
Presentation
- جهاز Presentation
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
addViewers(emailAddresses)
لإضافة مصفوفة المستخدمين المحددة إلى قائمة العارضين لـ Presentation
. إذا كان أي من المستخدمين مدرجًا بالفعل في قائمة المحررين، فلن يكون لهذه الطريقة أي تأثير عليهم.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
emailAddresses | String[] | مصفوفة من عناوين البريد الإلكتروني للمستخدمين المراد إضافتها. |
استرجاع الكرة
Presentation
- جهاز Presentation
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
appendSlide()
لإلحاق شريحة بنهاية العرض التقديمي باستخدام التنسيق PredefinedLayout.BLANK
المحدّد مسبقًا استنادًا إلى الشريحة الرئيسية الحالية. الشريحة الرئيسية الحالية هي واحدة مما يلي:
- الجزء الرئيسي من الشريحة الأخيرة الحالية.
- الشريحة الرئيسية الأولى في العرض التقديمي، إذا لم تكن هناك شريحة.
استرجاع الكرة
Slide
- الشريحة الجديدة المُلحقة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
appendSlide(layout)
لإلحاق شريحة بنهاية العرض التقديمي باستخدام التخطيط المحدد بناءً على الشريحة الرئيسية الحالية. الشريحة الرئيسية الحالية هي واحدة مما يلي:
- الجزء الرئيسي من الشريحة الأخيرة الحالية.
- الشريحة الرئيسية الأولى في العرض التقديمي، إذا لم تكن هناك شريحة.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
layout | Layout | التخطيط المراد استخدامه للشريحة الجديدة؛ يجب أن يكون موجودًا في الشريحة الرئيسية الحالية. |
استرجاع الكرة
Slide
- الشريحة الجديدة المُلحقة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
appendSlide(predefinedLayout)
ترفق شريحة بنهاية العرض التقديمي باستخدام التخطيط المحدد مسبقًا بناءً على الشريحة الرئيسية الحالية. الشريحة الرئيسية الحالية هي واحدة مما يلي:
- الجزء الرئيسي من الشريحة الأخيرة الحالية.
- الشريحة الرئيسية الأولى في العرض التقديمي، إذا لم تكن هناك شريحة.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
predefinedLayout | PredefinedLayout | التنسيق المحدد مسبقًا لاستخدامه مع الشريحة الجديدة، ويجب أن يتوفر في الشريحة الرئيسية الحالية. |
استرجاع الكرة
Slide
- الشريحة الجديدة المُلحقة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
appendSlide(slide)
لإلحاق نسخة من Slide
المقدَّمة بنهاية العرض التقديمي.
إذا كانت الشريحة التي يتم نسخها من عرض تقديمي مختلف، فسيتم نسخ الصفحة الرئيسية الرئيسية وصفحات التنسيق أيضًا إذا لم تكن موجودة بالفعل في هذا العرض التقديمي.
// Copy a slide from another presentation and appends it. var otherPresentation = SlidesApp.openById('presentationId'); var currentPresentation = SlidesApp.getActivePresentation(); var slide = otherPresentation.getSlides()[0]; currentPresentation.appendSlide(slide);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
slide | Slide | الشريحة المطلوب نسخها وإلحاقها |
استرجاع الكرة
Slide
- الشريحة الجديدة المُلحقة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
appendSlide(slide, linkingMode)
لإلحاق نسخة من Slide
المقدَّمة من العرض التقديمي المصدر إلى نهاية
العرض التقديمي الحالي، وضبط رابط الشريحة على النحو المحدّد في SlideLinkingMode
.
إذا كانت الشريحة التي يتم نسخها من عرض تقديمي مختلف، فسيتم نسخ الصفحة الرئيسية الرئيسية وصفحات التنسيق أيضًا إذا لم تكن موجودة بالفعل في العرض التقديمي الحالي.
إذا كان وضع الرابط هو SlideLinkingMode.LINKED
، يمكن تعديل الشريحة المرفقة لمطابقة الشريحة المصدر المقدّمة عند استدعاء Slide.refreshSlide()
. يمكن للمتعاونين الآخرين رؤية
الرابط لشريحة المصدر. لا يمكن استخدام SlideLinkingMode.LINKED
مع الشرائح المصدر
من العرض التقديمي الحالي.
// Copy a slide from another presentation, then append and link it. var sourcePresentation = SlidesApp.openById('presentationId'); var currentPresentation = SlidesApp.getActivePresentation(); var slide = sourcePresentation.getSlides()[0]; var appendedSlide = currentPresentation.appendSlide(slide, SlidesApp.SlideLinkingMode.LINKED);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
slide | Slide | الشريحة المطلوب نسخها وإلحاقها وربطها |
linkingMode | SlideLinkingMode | وضع الربط المطلوب استخدامه. |
استرجاع الكرة
Slide
— الشريحة الجديدة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getEditors()
يمكنك الحصول على قائمة بالمحرِّرين في Presentation
.
استرجاع الكرة
User[]
- مصفوفة من المستخدمين الذين لديهم إذن بالتعديل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getId()
الحصول على المعرّف الفريد للعرض التقديمي يتم استخدام معرّف العرض التقديمي مع SlidesApp.openById()
لفتح مثيل عرض تقديمي محدّد.
استرجاع الكرة
String
- رقم تعريف هذا العرض التقديمي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLayouts()
الحصول على التنسيقات في العرض التقديمي
استرجاع الكرة
Layout[]
- قائمة التنسيقات في هذا العرض التقديمي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getMasters()
الحصول على الخبراء في العرض التقديمي.
استرجاع الكرة
Master[]
— قائمة الشرائح الرئيسية في هذا العرض التقديمي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getName()
الحصول على اسم العرض التقديمي أو عنوانه
استرجاع الكرة
String
— عنوان هذا العرض التقديمي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getNotesMaster()
الحصول على الملاحظات الرئيسية للعرض التقديمي.
استرجاع الكرة
NotesMaster
— المشرف على العرض التقديمي:
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getNotesPageHeight()
للحصول على ارتفاع صفحة الملاحظات الرئيسية وصفحات الملاحظات في العرض التقديمي بالنقاط. وكلها لها نفس ارتفاع الصفحة.
استرجاع الكرة
Number
— ارتفاع صفحة الملاحظات بالنقاط
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getNotesPageWidth()
للحصول على عرض صفحة الملاحظات الرئيسية وصفحات الملاحظات في العرض التقديمي بالنقاط. فجميعها لها نفس عرض الصفحة.
استرجاع الكرة
Number
— عرض صفحة الملاحظات بالنقاط
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageElementById(id)
لعرض PageElement
بالمعرّف المحدّد، أو عرض null
في حال عدم توفّره.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
id | String | معرّف عنصر الصفحة الذي يتم استرداده |
استرجاع الكرة
PageElement
- عنصر الصفحة الذي يحمل المعرّف المحدّد
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageHeight()
الحصول على ارتفاع صفحة الشرائح والتنسيقات والعروض الرئيسية في العرض التقديمي بالنقاط. وكلها لها نفس ارتفاع الصفحة.
استرجاع الكرة
Number
— ارتفاع الصفحة بالنقاط.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageWidth()
للحصول على عرض الصفحة للشرائح والتنسيقات والشرائح الرئيسية في العرض التقديمي بالنقاط. فجميعها لها نفس عرض الصفحة.
استرجاع الكرة
Number
— عرض الصفحة بالنقاط.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getSelection()
لعرض اختيار المستخدم في العرض التقديمي النشط لا يمكن للنص البرمجي الوصول إلا إلى اختيار المستخدم الذي يشغِّل النص البرمجي، وفقط إذا تم ربط النص البرمجي بالعرض التقديمي.
تجدر الإشارة إلى أنّ الاختيار الذي تم عرضه هو الاختيار الحالي الفعّال. أثناء إجراء النص لتغييرات مختلفة على العرض التقديمي، يتم تحويل التحديد لمراعاة هذه التغييرات. على سبيل المثال، إذا تم تحديد الشكلين A وB، ثم قام البرنامج النصي بإزالة الشكل B، فسيتم تحديث كائن التحديد المعروض بشكل ضمني بحيث يتم تحديد الشكل A فقط.
// Gets the current active page that is selected in the active presentation. var selection = SlidesApp.getActivePresentation().getSelection(); var currentPage = selection.getCurrentPage();
استرجاع الكرة
Selection
: تمثيل لاختيار المستخدم أو null
إذا كان النص البرمجي غير مرتبط
بالعرض التقديمي أو إذا لم يكن هناك اختيار صالح للمستخدم.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getSlideById(id)
لعرض Slide
بالمعرّف المحدّد، أو عرض null
في حال عدم توفّره.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
id | String | رقم تعريف الشريحة التي يتم استردادها. |
استرجاع الكرة
Slide
- الشريحة التي تتضمّن المعرّف المحدّد
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getSlides()
الحصول على الشرائح في العرض التقديمي.
استرجاع الكرة
Slide[]
- قائمة الشرائح في هذا العرض التقديمي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getUrl()
استرداد عنوان URL للوصول إلى هذا العرض التقديمي.
var presentation = SlidesApp.getActivePresentation(); // Send out the link to open the presentation. MailApp.sendEmail("<email-address>", presentation.getName(), presentation.getUrl());
استرجاع الكرة
String
- عنوان URL للوصول إلى العرض التقديمي الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getViewers()
للحصول على قائمة المشاهدين والمعلقين على Presentation
هذا.
استرجاع الكرة
User[]
: مصفوفة من المستخدمين الذين لديهم إذن بالعرض أو التعليق.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSlide(insertionIndex)
يدرج شريحة في الفهرس المحدد في العرض التقديمي باستخدام تنسيق PredefinedLayout.BLANK
المحدد مسبقًا استنادًا إلى الشريحة الرئيسية الحالية. المشرف الحالي
هو واحد مما يلي:
- الجزء الرئيسي من الشريحة السابقة.
- الشريحة الرئيسية من الشريحة الأولى، إذا كان InsertIndex صفرًا
- الشريحة الرئيسية الأولى في العرض التقديمي، إذا لم تكن هناك شريحة.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
insertionIndex | Integer | فهرس مستند إلى صفر يشير إلى مكان إدراج الشريحة. |
استرجاع الكرة
Slide
- الشريحة الجديدة التي يتم إدراجها
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSlide(insertionIndex, layout)
يدرج شريحة في الفهرس المحدد في العرض التقديمي باستخدام التنسيق المحدد بناءً على الشريحة الرئيسية الحالية. الشريحة الرئيسية الحالية هي واحدة مما يلي:
- الجزء الرئيسي من الشريحة السابقة.
- الشريحة الرئيسية من الشريحة الأولى، إذا كان InsertIndex صفرًا
- الشريحة الرئيسية الأولى في العرض التقديمي، إذا لم تكن هناك شريحة.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
insertionIndex | Integer | فهرس مستند إلى صفر يشير إلى مكان إدراج الشريحة. |
layout | Layout | التخطيط المراد استخدامه للشريحة الجديدة؛ يجب أن يكون موجودًا في الشريحة الرئيسية الحالية. |
استرجاع الكرة
Slide
- الشريحة الجديدة التي يتم إدراجها
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSlide(insertionIndex, predefinedLayout)
يدرج شريحة في الفهرس المحدد في العرض التقديمي باستخدام التخطيط المحدد مسبقًا استنادًا إلى الشريحة الرئيسية الحالية. الشريحة الرئيسية الحالية هي واحدة مما يلي:
- الجزء الرئيسي من الشريحة السابقة.
- الشريحة الرئيسية من الشريحة الأولى، إذا كان InsertIndex صفرًا
- الشريحة الرئيسية الأولى في العرض التقديمي، إذا لم تكن هناك شريحة.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
insertionIndex | Integer | فهرس مستند إلى صفر يشير إلى مكان إدراج الشريحة. |
predefinedLayout | PredefinedLayout | التنسيق المحدد مسبقًا لاستخدامه مع الشريحة الجديدة، ويجب أن يتوفر في الشريحة الرئيسية الحالية. |
استرجاع الكرة
Slide
- الشريحة الجديدة التي يتم إدراجها
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSlide(insertionIndex, slide)
يدرج نسخة من Slide
المتوفرة في الفهرس المحدد في العرض التقديمي.
إذا كانت الشريحة التي يتم نسخها من عرض تقديمي مختلف، فسيتم نسخ الصفحة الرئيسية الرئيسية وصفحات التنسيق أيضًا إذا لم تكن موجودة بالفعل في هذا العرض التقديمي.
// Copy a slide from another presentation and inserts it. var otherPresentation = SlidesApp.openById('presentationId'); var currentPresentation = SlidesApp.getActivePresentation(); var slide = otherPresentation.getSlides()[0]; var insertionIndex = 1; currentPresentation.insertSlide(insertionIndex, slide);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
insertionIndex | Integer | فهرس مستند إلى صفر يشير إلى مكان إدراج الشريحة. |
slide | Slide | الشريحة المراد نسخها وإدراجها |
استرجاع الكرة
Slide
- الشريحة الجديدة التي يتم إدراجها
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSlide(insertionIndex, slide, linkingMode)
يدرج نسخة من Slide
المقدَّمة من العرض التقديمي المصدر في الفهرس المحدّد في العرض التقديمي الحالي، ويضبط رابط الشريحة على النحو المحدّد في SlideLinkingMode
.
إذا كانت الشريحة التي يتم نسخها من عرض تقديمي مختلف، فسيتم نسخ الصفحة الرئيسية الرئيسية وصفحات التنسيق أيضًا إذا لم تكن موجودة بالفعل في العرض التقديمي الحالي.
إذا كان وضع الرابط هو SlideLinkingMode.LINKED
، يمكن تعديل الشريحة المدرجة لمطابقة شريحة المصدر المقدمة عند استدعاء Slide.refreshSlide()
. يمكن للمتعاونين الآخرين رؤية
الرابط لشريحة المصدر. لا يمكن استخدام SlideLinkingMode.LINKED
مع الشرائح المصدر
من العرض التقديمي الحالي.
// Copy a slide from another presentation, then insert and link it. var sourcePresentation = SlidesApp.openById('presentationId'); var currentPresentation = SlidesApp.getActivePresentation(); var slide = sourcePresentation.getSlides()[0]; var insertionIndex = 1; var insertedSlide = currentPresentation.insertSlide( insertionIndex, slide, SlidesApp.SlideLinkingMode.LINKED);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
insertionIndex | Integer | فهرس مستند إلى صفر يشير إلى مكان إدراج الشريحة. |
slide | Slide | الشريحة المراد نسخها وإدراجها |
linkingMode | SlideLinkingMode | وضع الربط المطلوب استخدامه. |
استرجاع الكرة
Slide
— الشريحة الجديدة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
removeEditor(emailAddress)
لإزالة المستخدم المحدّد من قائمة المحرِّرين في Presentation
. ولا تحظر هذه الطريقة المستخدمين من الوصول إلى Presentation
إذا كانوا ينتمون إلى فئة من المستخدمين الذين لديهم إذن وصول عام، مثلاً إذا تمت مشاركة Presentation
مع نطاق المستخدم بأكمله، أو إذا كانت Presentation
في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.
بالنسبة إلى ملفات Drive، سيؤدي هذا أيضًا إلى إزالة المستخدم من قائمة العارضين.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
emailAddress | String | عنوان البريد الإلكتروني للمستخدم المطلوب إزالته. |
استرجاع الكرة
Presentation
- جهاز Presentation
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
removeEditor(user)
لإزالة المستخدم المحدّد من قائمة المحرِّرين في Presentation
. ولا تحظر هذه الطريقة المستخدمين من الوصول إلى Presentation
إذا كانوا ينتمون إلى فئة من المستخدمين الذين لديهم إذن وصول عام، مثلاً إذا تمت مشاركة Presentation
مع نطاق المستخدم بأكمله، أو إذا كانت Presentation
في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.
بالنسبة إلى ملفات Drive، سيؤدي هذا أيضًا إلى إزالة المستخدم من قائمة العارضين.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
user | User | تمثيل للمستخدم المطلوب إزالته. |
استرجاع الكرة
Presentation
- جهاز Presentation
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
removeViewer(emailAddress)
لإزالة المستخدم المحدّد من قائمة المشاهدين والمعلقين في Presentation
. ليس لهذه الطريقة تأثير إذا كان المستخدم محررًا، وليس مشاهدًا أو معلقًا. ولا تمنع هذه الطريقة المستخدمين من الوصول إلى Presentation
إذا كانوا ينتمون إلى فئة من المستخدمين الذين لديهم إذن وصول عام، مثلاً إذا تمت مشاركة Presentation
مع نطاق المستخدم بالكامل أو إذا كانت Presentation
في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.
بالنسبة إلى ملفات Drive، سيؤدي هذا أيضًا إلى إزالة المستخدم من قائمة المحرِّرين.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
emailAddress | String | عنوان البريد الإلكتروني للمستخدم المطلوب إزالته. |
استرجاع الكرة
Presentation
- جهاز Presentation
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
removeViewer(user)
لإزالة المستخدم المحدّد من قائمة المشاهدين والمعلقين في Presentation
. ليس لهذه الطريقة أي تأثير إذا كان المستخدم محررًا وليس عارضًا. ولا تمنع هذه الطريقة المستخدمين من الوصول إلى Presentation
إذا كانوا ينتمون لفئة معيّنة من المستخدمين يمكنهم الوصول بشكل عام، مثلاً إذا تمت مشاركة Presentation
مع النطاق الكامل للمستخدم، أو إذا كانت Presentation
في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.
بالنسبة إلى ملفات Drive، سيؤدي هذا أيضًا إلى إزالة المستخدم من قائمة المحرِّرين.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
user | User | تمثيل للمستخدم المطلوب إزالته. |
استرجاع الكرة
Presentation
- جهاز Presentation
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceAllText(findText, replaceText)
لاستبدال جميع تكرارات النص المطابق للبحث عن النص باستبدال النص. فإن البحث غير حساس لحالة الأحرف.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
findText | String | النص المطلوب البحث عنه |
replaceText | String | النص المطلوب استبدال النص المطابق له. |
استرجاع الكرة
Integer
- تم تغيير عدد التكرارات
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceAllText(findText, replaceText, matchCase)
لاستبدال جميع تكرارات النص المطابق للبحث عن النص باستبدال النص.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
findText | String | النص المطلوب البحث عنه |
replaceText | String | النص المطلوب استبدال النص المطابق له. |
matchCase | Boolean | إذا كان البحث true ، يكون البحث حسّاسًا لحالة الأحرف. أمّا إذا كان false ، فسيكون البحث غير حساس لحالة الأحرف. |
استرجاع الكرة
Integer
- تم تغيير عدد التكرارات
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
saveAndClose()
حفظ Presentation
الحالية يؤدي إلى مسح التحديثات في انتظار المراجعة وتطبيقها.
يتم استدعاء الإجراء saveAndClose()
تلقائيًا في نهاية تنفيذ النص البرمجي لكل Presentation
مفتوح، حتى إذا تم إنهاء تنفيذ النص البرمجي مع حدوث خطأ.
لا يمكن تعديل Presentation
مغلق. استخدِم إحدى الطرق المفتوحة على SlidesApp
لإعادة فتح عرض تقديمي معيَّن للتعديل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setName(name)
تحدِّد هذه السياسة اسم العرض التقديمي أو عنوانه.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
name | String | الاسم الذي سيتم تعيينه لهذا العرض التقديمي. |
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations