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 إذا لم يتم العثور على قيم.
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. إذا كان المستخدم مدرجًا حاليًا في قائمة المشاهدين، ستؤدي هذه الطريقة إلى استبعاد المستخدم من قائمة المشاهدين.

المعلّمات

الاسمالنوعالوصف
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.
var otherPresentation = SlidesApp.openById('presentationId');
var currentPresentation = SlidesApp.getActivePresentation();
var 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.
var sourcePresentation = SlidesApp.openById('presentationId');
var currentPresentation = SlidesApp.getActivePresentation();
var slide = sourcePresentation.getSlides()[0];
var 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 إذا لم يتم العثور على قيم.

المعلّمات

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

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

وتجدُر الإشارة إلى أنّ الاختيار المعروض هو الاختيار الحالي الفعّال. وبينما يُجري النص البرمجي تغييرات مختلفة على العرض التقديمي، يتم تغيير الاختيار لأخذه في الاعتبار. على سبيل المثال، إذا تم اختيار الشكلين 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 إذا لم يتم العثور على قيم.

المعلّمات

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

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

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

المعلّمات

الاسمالنوعالوصف
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.
var otherPresentation = SlidesApp.openById('presentationId');
var currentPresentation = SlidesApp.getActivePresentation();
var slide = otherPresentation.getSlides[0];
var 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.
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);

المعلّمات

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

تذكرة ذهاب وعودة

Slide — الشريحة الجديدة.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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

removeEditor(emailAddress)

إزالة المستخدم المحدّد من قائمة محرّري 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 في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.

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

المعلّمات

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

تذكرة ذهاب وعودة

Presentation — هذا Presentation، للسلسلة.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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

removeViewer(emailAddress)

إزالة المستخدم المحدد من قائمة المشاهدين والمعلقين لـ 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