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. إذا كان المستخدم مُدرَجًا في قائمة المشاهدين، تُخرج هذه الطريقة المستخدم من قائمة المشاهدين.

المعلمات

الاسمالنوعالوصف
emailAddressStringعنوان البريد الإلكتروني للمستخدم الذي تريد إضافته

الإرجاع

Presentation — هذا الرمز Presentation، لإنشاء سلسلة.

التفويض

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

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

addEditor(user)

تُضيف هذه السمة المستخدم المحدّد إلى قائمة المحرِّرين في Presentation. إذا كان المستخدم مُدرَجًا في قائمة المشاهدين، تُخرج هذه الطريقة المستخدم من قائمة المشاهدين.

المعلمات

الاسمالنوعالوصف
userUserتمثيل للمستخدم المطلوب إضافته

الإرجاع

Presentation — هذا الرمز Presentation، لإنشاء سلسلة.

التفويض

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

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

addEditors(emailAddresses)

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

المعلمات

الاسمالنوعالوصف
emailAddressesString[]صفيف من عناوين البريد الإلكتروني للمستخدمين المطلوب إضافتهم

الإرجاع

Presentation — هذا الرمز Presentation، لإنشاء سلسلة.

التفويض

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

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

addViewer(emailAddress)

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

المعلمات

الاسمالنوعالوصف
emailAddressStringعنوان البريد الإلكتروني للمستخدم الذي تريد إضافته

الإرجاع

Presentation — هذا الرمز Presentation، لإنشاء سلسلة.

التفويض

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

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

addViewer(user)

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

المعلمات

الاسمالنوعالوصف
userUserتمثيل للمستخدم المطلوب إضافته

الإرجاع

Presentation — هذا الرمز Presentation، لإنشاء سلسلة.

التفويض

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

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

addViewers(emailAddresses)

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

المعلمات

الاسمالنوعالوصف
emailAddressesString[]صفيف من عناوين البريد الإلكتروني للمستخدمين المطلوب إضافتهم

الإرجاع

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)

إلحاق شريحة بنهاية العرض التقديمي باستخدام التنسيق المحدّد استنادًا إلى ملف التنسيق الأساسي الحالي يكون الملف الرئيسي الحالي أحد الملفات التالية:

  • الشريحة الرئيسية للشريحة الأخيرة الحالية
  • الشريحة الرئيسية الأولى في العرض التقديمي، في حال عدم توفّر شريحة

المعلمات

الاسمالنوعالوصف
layoutLayoutتنسيق الشريحة الجديدة، ويجب أن يكون متوفّرًا في الشريحة الرئيسية الحالية.

الإرجاع

Slide: الشريحة الجديدة التي يتم إلحاقها.

التفويض

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

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

appendSlide(predefinedLayout)

إلحاق شريحة بنهاية العرض التقديمي باستخدام التنسيق المحدّد مسبقًا والمحدّد استنادًا إلى النموذج الرئيسي الحالي يكون الملف الرئيسي الحالي أحد الملفات التالية:

  • الشريحة الرئيسية للشريحة الأخيرة الحالية
  • الشريحة الرئيسية الأولى في العرض التقديمي، في حال عدم توفّر شريحة

المعلمات

الاسمالنوعالوصف
predefinedLayoutPredefinedLayoutالتنسيق المحدّد مسبقًا لاستخدامه في الشريحة الجديدة، ويجب أن يكون متوفّرًا في الصفحة الرئيسية الحالية.

الإرجاع

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);

المعلمات

الاسمالنوعالوصف
slideSlideالشريحة المطلوب نسخها وإضافتها.

الإرجاع

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,
);

المعلمات

الاسمالنوعالوصف
slideSlideالشريحة التي سيتم نسخها وإرفاقها وربطها
linkingModeSlideLinkingModeوضع الرابط المطلوب استخدامه

الإرجاع

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

المعلمات

الاسمالنوعالوصف
idStringمعرّف عنصر الصفحة الذي يتم استرجاعه.

الإرجاع

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

المعلمات

الاسمالنوعالوصف
idStringرقم تعريف الشريحة التي يتم استرجاعها.

الإرجاع

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 استنادًا إلى الشريحة الرئيسية الحالية. الملف الرئيسي الحالي هو أحد الملفات التالية:

  • الشريحة الرئيسية للشريحة السابقة.
  • الشريحة الرئيسية للشريحة الأولى، إذا كان موضع الإدراج يساوي صفرًا
  • الشريحة الرئيسية الأولى في العرض التقديمي، في حال عدم توفّر شريحة

المعلمات

الاسمالنوعالوصف
insertionIndexIntegerالفهرس المستند إلى الصفر الذي يشير إلى موضع إدراج الشريحة

الإرجاع

Slide: الشريحة الجديدة التي يتم إدراجها

التفويض

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

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

insertSlide(insertionIndex, layout)

تُدرج هذه الدالة شريحة في الفهرس المحدّد في العرض التقديمي باستخدام التنسيق المحدّد استنادًا إلى الشريحة الرئيسية الحالية. يكون الملف الرئيسي الحالي أحد الملفات التالية:

  • الشريحة الرئيسية للشريحة السابقة.
  • الشريحة الرئيسية للشريحة الأولى، إذا كان موضع الإدراج يساوي صفرًا
  • الشريحة الرئيسية الأولى في العرض التقديمي، في حال عدم توفّر شريحة

المعلمات

الاسمالنوعالوصف
insertionIndexIntegerالفهرس المستند إلى الصفر الذي يشير إلى موضع إدراج الشريحة
layoutLayoutتنسيق الشريحة الجديدة، ويجب أن يكون متوفّرًا في الشريحة الرئيسية الحالية.

الإرجاع

Slide: الشريحة الجديدة التي يتم إدراجها

التفويض

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

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

insertSlide(insertionIndex, predefinedLayout)

تُدرج هذه الدالة شريحة في الفهرس المحدّد في العرض التقديمي باستخدام التنسيق المحدد مسبقًا استنادًا إلى الشريحة الرئيسية الحالية. يكون الملف الرئيسي الحالي أحد الملفات التالية:

  • الشريحة الرئيسية للشريحة السابقة.
  • الشريحة الرئيسية للشريحة الأولى، إذا كان موضع الإدراج يساوي صفرًا
  • الشريحة الرئيسية الأولى في العرض التقديمي، في حال عدم توفّر شريحة

المعلمات

الاسمالنوعالوصف
insertionIndexIntegerالفهرس المستند إلى الصفر الذي يشير إلى موضع إدراج الشريحة
predefinedLayoutPredefinedLayoutالتنسيق المحدّد مسبقًا لاستخدامه في الشريحة الجديدة، ويجب أن يكون متوفّرًا في الصفحة الرئيسية الحالية.

الإرجاع

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);

المعلمات

الاسمالنوعالوصف
insertionIndexIntegerالفهرس المستند إلى الصفر الذي يشير إلى موضع إدراج الشريحة
slideSlideالشريحة التي سيتم نسخها وإدراجها.

الإرجاع

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,
);

المعلمات

الاسمالنوعالوصف
insertionIndexIntegerالفهرس المستند إلى الصفر الذي يشير إلى موضع إدراج الشريحة
slideSlideالشريحة التي سيتم نسخها وإدراجها.
linkingModeSlideLinkingModeوضع الرابط المطلوب استخدامه

الإرجاع

Slide: الشريحة الجديدة

التفويض

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

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

removeEditor(emailAddress)

تزيل هذه الدالة المستخدم المحدّد من قائمة المحرِّرين في Presentation. لا تؤدي هذه الطريقة إلى منع المستخدمين من الوصول إلى Presentation إذا كانوا ينتمون إلى فئة من المستخدمين الذين لديهم إذن بالوصول العام، على سبيل المثال، إذا تمت مشاركة Presentation مع Presentation للمستخدم بالكامل، أو إذا كان Presentation في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.

بالنسبة إلى ملفات Drive، يؤدي ذلك أيضًا إلى إزالة المستخدم من قائمة المشاهدين.

المعلمات

الاسمالنوعالوصف
emailAddressStringعنوان البريد الإلكتروني للمستخدم المطلوب إزالته

الإرجاع

Presentation — هذا الرمز Presentation، لإنشاء سلسلة.

التفويض

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

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

removeEditor(user)

تزيل هذه الدالة المستخدم المحدّد من قائمة المحرِّرين في Presentation. لا تؤدي هذه الطريقة إلى منع المستخدمين من الوصول إلى Presentation إذا كانوا ينتمون إلى فئة من المستخدمين الذين لديهم إذن بالوصول العام، على سبيل المثال، إذا تمت مشاركة Presentation مع Presentation للمستخدم بالكامل، أو إذا كان Presentation في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.

بالنسبة إلى ملفات Drive، يؤدي ذلك أيضًا إلى إزالة المستخدم من قائمة المشاهدين.

المعلمات

الاسمالنوعالوصف
userUserتمثيل للمستخدم المطلوب إزالته

الإرجاع

Presentation — هذا الرمز Presentation، لإنشاء سلسلة.

التفويض

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

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

removeViewer(emailAddress)

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

بالنسبة إلى ملفات Drive، يؤدي ذلك أيضًا إلى إزالة المستخدم من قائمة المحرِّرين.

المعلمات

الاسمالنوعالوصف
emailAddressStringعنوان البريد الإلكتروني للمستخدم المطلوب إزالته

الإرجاع

Presentation — هذا Presentation لإنشاء سلسلة.

التفويض

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

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

removeViewer(user)

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

بالنسبة إلى ملفات Drive، يؤدي ذلك أيضًا إلى إزالة المستخدم من قائمة المحرِّرين.

المعلمات

الاسمالنوعالوصف
userUserتمثيل للمستخدم المطلوب إزالته

الإرجاع

Presentation — هذا Presentation لإنشاء سلسلة.

التفويض

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

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

replaceAllText(findText, replaceText)

استبدال جميع تكرارات النص الذي يتطابق مع النص المراد البحث عنه بالنص البديل البحث غير حساس لحالة الأحرف.

المعلمات

الاسمالنوعالوصف
findTextStringالنص المطلوب البحث عنه.
replaceTextStringالنص الذي سيتم استبدال النص المطابق به.

الإرجاع

Integer - تم تغيير عدد مرات التكرار

التفويض

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

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

replaceAllText(findText, replaceText, matchCase)

استبدال جميع تكرارات النص الذي يتطابق مع النص المراد البحث عنه بالنص البديل

المعلمات

الاسمالنوعالوصف
findTextStringالنص المطلوب البحث عنه.
replaceTextStringالنص الذي سيتم استبدال النص المطابق به.
matchCaseBooleanإذا كان الخيار 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)

لضبط اسم العرض التقديمي أو عنوانه

المعلمات

الاسمالنوعالوصف
nameStringالاسم الذي سيتم ضبطه لهذا العرض التقديمي.

التفويض

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

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