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|nullتعرض هذه الدالة PageElement الذي يحمل المعرّف المحدّد، أو null إذا لم يكن هناك أي معرّف.
getPageHeight()Numberتعرض هذه الطريقة ارتفاع الصفحة للشرائح والتنسيقات والشرائح الرئيسية في العرض التقديمي بالنقاط.
getPageWidth()Numberتعرض هذه الدالة عرض الصفحة للشرائح والتنسيقات والشرائح الرئيسية في العرض التقديمي بالنقاط.
getSelection()Selection|nullتعرض هذه الدالة النص الذي اختاره المستخدم في العرض التقديمي النشط.
getSlideById(id)Slide|nullتعرِض هذه الدالة 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.
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 إذا لم يكن هناك أي معرّف.

المَعلمات

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

الإرجاع

PageElement|null: عنصر الصفحة الذي يتضمّن المعرّف المحدّد

التفويض

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

  • 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.
const selection = SlidesApp.getActivePresentation().getSelection();
const currentPage = selection.getCurrentPage();

الإرجاع

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

التفويض

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

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

getSlideById(id)

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

المَعلمات

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

الإرجاع

Slide|null: الشريحة التي تحمل رقم التعريف المحدّد

التفويض

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

  • 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 هو صفر
  • الشريحة الرئيسية الأولى في العرض التقديمي، إذا لم تكن هناك شريحة

المَعلمات

الاسمالنوعالوصف
insertionIndexIntegerالفهرس الذي يبدأ من 0 والذي يشير إلى مكان إدراج الشريحة.

الإرجاع

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

التفويض

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

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

insertSlide(insertionIndex, layout)

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

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

المَعلمات

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

الإرجاع

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

التفويض

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

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

insertSlide(insertionIndex, predefinedLayout)

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

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

المَعلمات

الاسمالنوعالوصف
insertionIndexIntegerالفهرس الذي يبدأ من 0 والذي يشير إلى مكان إدراج الشريحة.
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الفهرس الذي يبدأ من 0 والذي يشير إلى مكان إدراج الشريحة.
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الفهرس الذي يبدأ من 0 والذي يشير إلى مكان إدراج الشريحة.
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