عرض تقديمي.
الطُرق
الطريقة | نوع الإرجاع | وصف قصير |
---|---|---|
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
. إذا كان المستخدم مدرجًا حاليًا
في قائمة المشاهدين، ستؤدي هذه الطريقة إلى استبعاد المستخدم من قائمة المشاهدين.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
emailAddress | String | عنوان البريد الإلكتروني للمستخدم المطلوب إضافته. |
تذكرة ذهاب وعودة
Presentation
— هذا Presentation
، للسلسلة.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
addEditor(user)
إضافة المستخدم المحدد إلى قائمة محررات Presentation
. إذا كان المستخدم مدرجًا حاليًا
في قائمة المشاهدين، ستؤدي هذه الطريقة إلى استبعاد المستخدم من قائمة المشاهدين.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
user | User | تمثيل للمستخدم لإضافته. |
تذكرة ذهاب وعودة
Presentation
— هذا Presentation
، للسلسلة.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
addEditors(emailAddresses)
لإضافة صفيف معيّن من المستخدمين إلى قائمة محرّري Presentation
. وإذا كان أيٌّ من المستخدمين مدرجًا في قائمة المشاهدين، تتيح لهم هذه الطريقة استبعادهم من قائمة المشاهدين.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
emailAddresses | String[] | مصفوفة من عناوين البريد الإلكتروني للمستخدمين المطلوب إضافتها. |
تذكرة ذهاب وعودة
Presentation
— هذا Presentation
، للسلسلة.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
addViewer(emailAddress)
تعمل على إضافة المستخدم المحدد إلى قائمة مشاهدي Presentation
. إذا كان المستخدم مدرَجًا في قائمة المحرّرين، لن يكون لهذه الطريقة أي تأثير.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
emailAddress | String | عنوان البريد الإلكتروني للمستخدم المطلوب إضافته. |
تذكرة ذهاب وعودة
Presentation
— هذا Presentation
، للسلسلة.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
addViewer(user)
تعمل على إضافة المستخدم المحدد إلى قائمة مشاهدي Presentation
. إذا كان المستخدم مدرَجًا في قائمة المحرّرين، لن يكون لهذه الطريقة أي تأثير.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
user | User | تمثيل للمستخدم لإضافته. |
تذكرة ذهاب وعودة
Presentation
— هذا Presentation
، للسلسلة.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
addViewers(emailAddresses)
تعمل هذه السياسة على إضافة المصفوفة المحدّدة من المستخدمين إلى قائمة المشاهدين للوحدة التنظيمية Presentation
. إذا كان أي من المستخدمين مدرجًا في قائمة أدوات التحرير، لن يكون لهذه الطريقة أي تأثير.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
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)
لإلحاق شريحة في نهاية العرض التقديمي باستخدام التنسيق المحدّد استنادًا إلى الشريحة الرئيسية الحالية. الشريحة الرئيسية الحالية هي واحدة مما يلي:
- الشريحة الرئيسية الأخيرة الحالية.
- الشريحة الرئيسية الأولى في العرض التقديمي، إذا لم تكن هناك شريحة.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
layout | Layout | التنسيق المطلوب استخدامه للشريحة الجديدة، ويجب أن يكون التنسيق متوفرًا في الشريحة الرئيسية الحالية. |
تذكرة ذهاب وعودة
Slide
- الشريحة الجديدة التي تم إلحاقها.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
appendSlide(predefinedLayout)
لإلحاق شريحة بنهاية العرض التقديمي باستخدام التنسيق المحدّد مسبقًا استنادًا إلى الشريحة الرئيسية الحالية. الشريحة الرئيسية الحالية هي واحدة مما يلي:
- الشريحة الرئيسية الأخيرة الحالية.
- الشريحة الرئيسية الأولى في العرض التقديمي، إذا لم تكن هناك شريحة.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
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);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
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);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
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
إذا لم يتم العثور على قيم.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
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
إذا لم يتم العثور على قيم.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
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
المحدّد مسبقًا استنادًا إلى الشريحة الرئيسية الحالية. الشريحة الرئيسية الحالية هي واحدة من
المعلومات التالية:
- الشريحة الرئيسية السابقة.
- الشريحة الرئيسية الأولى، إذا كان فهرس الإدراج صفرًا.
- الشريحة الرئيسية الأولى في العرض التقديمي، إذا لم تكن هناك شريحة.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
insertionIndex | Integer | مؤشر غير صفري يوضح مكان إدراج الشريحة. |
تذكرة ذهاب وعودة
Slide
: الشريحة الجديدة التي تم إدراجها.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSlide(insertionIndex, layout)
يتم إدراج شريحة في الفهرس المحدّد في العرض التقديمي باستخدام التنسيق المحدّد بناءً على الشريحة الرئيسية الحالية. الشريحة الرئيسية الحالية هي واحدة مما يلي:
- الشريحة الرئيسية السابقة.
- الشريحة الرئيسية الأولى، إذا كان فهرس الإدراج صفرًا.
- الشريحة الرئيسية الأولى في العرض التقديمي، إذا لم تكن هناك شريحة.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
insertionIndex | Integer | مؤشر غير صفري يوضح مكان إدراج الشريحة. |
layout | Layout | التنسيق المطلوب استخدامه للشريحة الجديدة، ويجب أن يكون التنسيق متوفرًا في الشريحة الرئيسية الحالية. |
تذكرة ذهاب وعودة
Slide
: الشريحة الجديدة التي تم إدراجها.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSlide(insertionIndex, predefinedLayout)
يتم إدراج شريحة في الفهرس المحدّد في العرض التقديمي باستخدام التنسيق المحدّد مسبقًا المحدّد استنادًا إلى الشريحة الرئيسية الحالية. الشريحة الرئيسية الحالية هي واحدة مما يلي:
- الشريحة الرئيسية السابقة.
- الشريحة الرئيسية الأولى، إذا كان فهرس الإدراج صفرًا.
- الشريحة الرئيسية الأولى في العرض التقديمي، إذا لم تكن هناك شريحة.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
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);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
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);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
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، يؤدي ذلك أيضًا إلى إزالة المستخدم من قائمة المشاهدين.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
emailAddress | String | عنوان البريد الإلكتروني للمستخدم المطلوب إزالته. |
تذكرة ذهاب وعودة
Presentation
— هذا Presentation
، للسلسلة.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
removeEditor(user)
إزالة المستخدم المحدّد من قائمة محرّري Presentation
. ولا تمنع هذه الطريقة المستخدمين من الوصول إلى Presentation
إذا كانوا ينتمون إلى فئة مستخدمين لديهم حق الوصول العام، مثلاً، في حال مشاركة Presentation
مع نطاق المستخدم بالكامل، أو إذا كانت Presentation
في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.
بالنسبة إلى ملفات Drive، يؤدي ذلك أيضًا إلى إزالة المستخدم من قائمة المشاهدين.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
user | User | تمثيل المستخدم المطلوب إزالته. |
تذكرة ذهاب وعودة
Presentation
— هذا Presentation
، للسلسلة.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
removeViewer(emailAddress)
إزالة المستخدم المحدد من قائمة المشاهدين والمعلقين لـ Presentation
. وليس لهذه الطريقة أي تأثير إذا كان المستخدم محرِّرًا وليس مشاهدًا أو معلِّقًا. هذه الطريقة أيضًا
لا تمنع المستخدمين من الوصول إلى Presentation
إذا كانوا ينتمون إلى فئة مستخدمين
لديهم حق الوصول العام، مثلاً، إذا تمت مشاركة Presentation
مع نطاق المستخدم بالكامل، أو إذا كانت Presentation
في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.
بالنسبة إلى ملفات Drive، يؤدي ذلك أيضًا إلى إزالة المستخدم من قائمة التحرير.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
emailAddress | String | عنوان البريد الإلكتروني للمستخدم المطلوب إزالته. |
تذكرة ذهاب وعودة
Presentation
— هذا Presentation
للسلاسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
removeViewer(user)
إزالة المستخدم المحدد من قائمة المشاهدين والمعلقين لـ Presentation
. وليس لهذه الطريقة أي تأثير إذا كان المستخدم محرِّرًا وليس مشاهدًا. هذه الطريقة أيضًا لا تمنع
المستخدمين من الوصول إلى Presentation
إذا كانوا ينتمون إلى فئة مستخدمين لديهم حق الوصول العام، مثلاً، إذا تمت مشاركة Presentation
مع نطاق المستخدم بالكامل، أو
إذا كانت Presentation
في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.
بالنسبة إلى ملفات Drive، يؤدي ذلك أيضًا إلى إزالة المستخدم من قائمة التحرير.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
user | User | تمثيل المستخدم المطلوب إزالته. |
تذكرة ذهاب وعودة
Presentation
— هذا Presentation
للسلاسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceAllText(findText, replaceText)
استبدال جميع مثيلات مطابقة النص للعثور على النص باستبدال النص. البحث غير حساس لحالة الأحرف.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
findText | String | النص المطلوب البحث عنه. |
replaceText | String | النص المطلوب استبدال النص المتطابق معه. |
تذكرة ذهاب وعودة
Integer
: تم تغيير عدد التكرارات
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceAllText(findText, replaceText, matchCase)
استبدال جميع مثيلات مطابقة النص للعثور على النص باستبدال النص.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
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)
يحدد اسم العرض التقديمي أو عنوانه.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
name | String | الاسم المحدّد لهذا العرض التقديمي. |
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations