Class Presentation

العرض التقديمي

عرض تقديمي

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
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 إذا لم يكن هناك أيّ PageElement
getPageHeight()	Number	تحصل على ارتفاع الصفحة للشرائح والتنسيقات والعناصر الرئيسية في العرض التقديمي بالنقاط.
getPageWidth()	Number	تحصل على عرض الصفحة للشرائح والتنسيقات والعناصر الرئيسية في العرض التقديمي بالنقاط.
getSelection()	Selection	تحصل على اختيار المستخدم في العرض النشط.
getSlideById(id)	Slide	عرض Slide بالمعرّف المحدّد، أو null إذا لم يكن هناك أيّ Slide
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.
const otherPresentation = SlidesApp.openById('presentationId');
const currentPresentation = SlidesApp.getActivePresentation();
const 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.
const sourcePresentation = SlidesApp.openById('presentationId');
const currentPresentation = SlidesApp.getActivePresentation();
const slide = sourcePresentation.getSlides()[0];
const 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 إذا لم يكن هناك أيّ PageElement

المعلَمات

الاسم	النوع	الوصف
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()

تحصل على اختيار المستخدم في العرض النشط. لا يمكن للنص البرمجي الوصول إلا إلى اختيار المستخدم الذي يشغّل النص البرمجي، وذلك فقط إذا كان النص البرمجي مرتبطًا بالعرض التقديمي.

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

// Gets the current active page that is selected in the active presentation.
const selection = SlidesApp.getActivePresentation().getSelection();
const currentPage = selection.getCurrentPage();

الإرجاع

Selection: تمثيل لاختيار المستخدم، أو null إذا لم يكن النص البرمجي مرتبطًا بالعرض التقديمي أو إذا لم يكن هناك اختيار صالح للمستخدم.

التفويض

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

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

---

getSlideById(id)

عرض Slide بالمعرّف المحدّد، أو null إذا لم يكن هناك أيّ Slide

المعلَمات

الاسم	النوع	الوصف
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 للوصول إلى هذا العرض التقديمي.

const 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.
const otherPresentation = SlidesApp.openById('presentationId');
const currentPresentation = SlidesApp.getActivePresentation();
const slide = otherPresentation.getSlides()[0];
const 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.
const sourcePresentation = SlidesApp.openById('presentationId');
const currentPresentation = SlidesApp.getActivePresentation();
const slide = sourcePresentation.getSlides()[0];
const insertionIndex = 1;
const 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 للمستخدم بالكامل، أو إذا كان 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 للمستخدم بالكامل، أو إذا كان 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 في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.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