تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

المعلّمات

الاسم	النوع	الوصف
`emailAddress`	`String`	عنوان البريد الإلكتروني للمستخدم المطلوب إضافته.

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

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

التفويض

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

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

`addEditor(user)`

المعلّمات

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

المعلّمات

الاسم	النوع	الوصف
`user`	`User`	تمثيل للمستخدم لإضافته.

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

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

التفويض

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

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

`addViewers(emailAddresses)`

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

المعلّمات

الاسم	النوع	الوصف
`emailAddresses`	`String[]`	مصفوفة من عناوين البريد الإلكتروني للمستخدمين المطلوب إضافتها.

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

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

التفويض

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

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

`appendSlide()`

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

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

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

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

التفويض

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

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

`appendSlide(layout)`

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

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

المعلّمات

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

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

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

التفويض

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

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

`appendSlide(predefinedLayout)`

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

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

المعلّمات

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

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

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

التفويض

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

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

`appendSlide(slide)`

لإلحاق نسخة من Slide المقدَّمة في نهاية العرض التقديمي.

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

// Copy a slide from another presentation and appends it.
var otherPresentation = SlidesApp.openById('presentationId');
var currentPresentation = SlidesApp.getActivePresentation();
var slide = otherPresentation.getSlides()[0];
currentPresentation.appendSlide(slide);

المعلّمات

الاسم	النوع	الوصف
`slide`	`Slide`	الشريحة التي سيتم نسخها وإضافتها.

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

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

التفويض

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

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

`appendSlide(slide, linkingMode)`

لإلحاق نسخة من Slide المقدَّم من العرض التقديمي المصدر في نهاية العرض التقديمي الحالي، وضبط رابط الشريحة على النحو المحدّد في SlideLinkingMode.

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

إذا كان وضع الرابط هو SlideLinkingMode.LINKED، يمكن تعديل الشريحة المضافة لتطابق الشريحة المصدر التي تم تقديمها عند استدعاء Slide.refreshSlide(). ويمكن للمتعاونين الآخرين الاطّلاع على الرابط الذي يؤدي إلى الشريحة المصدر. لا يمكن استخدام SlideLinkingMode.LINKED مع شرائح المصدر من العرض التقديمي الحالي.

// Copy a slide from another presentation, then append and link it.
var sourcePresentation = SlidesApp.openById('presentationId');
var currentPresentation = SlidesApp.getActivePresentation();
var slide = sourcePresentation.getSlides()[0];
var appendedSlide = currentPresentation.appendSlide(slide, SlidesApp.SlideLinkingMode.LINKED);

المعلّمات

الاسم	النوع	الوصف
`slide`	`Slide`	الشريحة التي سيتم نسخها وإلحاقها وربطها.
`linkingMode`	`SlideLinkingMode`	وضع الرابط المراد استخدامه.

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

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

التفويض

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

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

`getEditors()`

الحصول على قائمة المحرِّرين لجهاز Presentation هذا.

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

User[]: مصفوفة من المستخدمين لديهم إذن تعديل.

التفويض

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

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

`getId()`

يحصل على معرِّف فريد للعرض التقديمي. يتم استخدام معرّف العرض التقديمي مع SlidesApp.openById() لفتح مثيل عرض تقديمي معيّن.

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

String - رقم تعريف هذا العرض التقديمي.

التفويض

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

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

`getLayouts()`

الحصول على التنسيقات في العرض التقديمي

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

Layout[] — قائمة التنسيقات في هذا العرض التقديمي.

التفويض

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

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

`getMasters()`

للحصول على الشرائح الرئيسية في العرض التقديمي.

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

Master[] — قائمة الشرائح الرئيسية في هذا العرض التقديمي.

التفويض

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

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

`getName()`

يحصل على اسم العرض التقديمي أو عنوانه.

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

String: عنوان هذا العرض التقديمي.

التفويض

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

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

`getNotesMaster()`

الحصول على قائد الملاحظات للعرض التقديمي.

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

NotesMaster — المشرف الرئيسي للعرض التقديمي.

التفويض

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

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

`getNotesPageHeight()`

الحصول على ارتفاع الصفحة لرئيس الملاحظات وصفحات الملاحظات في العرض التقديمي بالنقاط. ولها جميعًا نفس ارتفاع الصفحة.

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

Number — ارتفاع صفحة الملاحظات بالنقاط.

التفويض

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

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

`getNotesPageWidth()`

الحصول على عرض الصفحة للملاحظات الرئيسية وصفحات الملاحظات في العرض التقديمي بالنقاط. تحمل جميعها العرض نفسه للصفحة.

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

Number — عرض صفحة الملاحظات بالنقاط.

التفويض

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

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

`getPageElementById(id)`

تعرض PageElement مع المعرّف المحدد، أو null إذا لم يتم العثور على قيم.

المعلّمات

الاسم	النوع	الوصف
`id`	`String`	رقم تعريف عنصر الصفحة الذي يتم استرداده

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

PageElement - عنصر الصفحة الذي يحمل المعرِّف المحدَّد.

التفويض

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

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

`getPageHeight()`

يحصل على ارتفاع الصفحة للشرائح والتنسيقات والشرائح الرئيسية في العرض التقديمي بالنقاط. ولها جميعًا نفس ارتفاع الصفحة.

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

Number — ارتفاع الصفحة بالنقاط.

التفويض

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

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

`getPageWidth()`

الحصول على عرض الصفحة للشرائح والتنسيقات والشرائح الرئيسية في العرض التقديمي بالنقاط. تحمل جميعها العرض نفسه للصفحة.

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

Number — عرض الصفحة بالنقاط.

التفويض

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

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

`getSelection()`

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

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

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

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

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

التفويض

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

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

`getSlideById(id)`

تعرض Slide مع المعرّف المحدد، أو null إذا لم يتم العثور على قيم.

المعلّمات

الاسم	النوع	الوصف
`id`	`String`	رقم تعريف الشريحة التي يتم استردادها.

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

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

التفويض

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

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

`getSlides()`

للحصول على الشرائح في العرض التقديمي.

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

Slide[] — قائمة الشرائح في هذا العرض التقديمي.

التفويض

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

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

`getUrl()`

لاسترداد عنوان URL للوصول إلى هذا العرض التقديمي.

var presentation = SlidesApp.getActivePresentation();

// Send out the link to open the presentation.
MailApp.sendEmail("<email-address>", presentation.getName(), presentation.getUrl());

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

String — عنوان URL للوصول إلى العرض التقديمي الحالي.

التفويض

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

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

`getViewers()`

يحصل على قائمة المشاهدين والمعلقين لجهاز Presentation هذا.

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

User[]: مصفوفة من المستخدمين الذين لديهم إذن عرض أو تعليق.

التفويض

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

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

`insertSlide(insertionIndex)`

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

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

المعلّمات

الاسم	النوع	الوصف
`insertionIndex`	`Integer`	مؤشر غير صفري يوضح مكان إدراج الشريحة.

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

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

التفويض

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

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

`insertSlide(insertionIndex, layout)`

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

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

المعلّمات

الاسم	النوع	الوصف
`insertionIndex`	`Integer`	مؤشر غير صفري يوضح مكان إدراج الشريحة.
`layout`	`Layout`	التنسيق المطلوب استخدامه للشريحة الجديدة، ويجب أن يكون التنسيق متوفرًا في الشريحة الرئيسية الحالية.

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

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

التفويض

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

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

`insertSlide(insertionIndex, predefinedLayout)`

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

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

المعلّمات

الاسم	النوع	الوصف
`insertionIndex`	`Integer`	مؤشر غير صفري يوضح مكان إدراج الشريحة.
`predefinedLayout`	`PredefinedLayout`	التنسيق المحدد مسبقًا لاستخدامه مع الشريحة الجديدة، ويجب أن يكون التنسيق متوفرًا في الشريحة الرئيسية الحالية.

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

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

التفويض

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

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

`insertSlide(insertionIndex, slide)`

إدراج نسخة من Slide المقدّمة في الفهرس المحدّد في العرض التقديمي.

// Copy a slide from another presentation and inserts it.
var otherPresentation = SlidesApp.openById('presentationId');
var currentPresentation = SlidesApp.getActivePresentation();
var slide = otherPresentation.getSlides[0];
var insertionIndex = 1;
currentPresentation.insertSlide(insertionIndex, slide);

المعلّمات

الاسم	النوع	الوصف
`insertionIndex`	`Integer`	مؤشر غير صفري يوضح مكان إدراج الشريحة.
`slide`	`Slide`	الشريحة التي سيتم نسخها وإدراجها.

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

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

التفويض

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

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

`insertSlide(insertionIndex, slide, linkingMode)`

تُدرِج نسخة من السمة Slide المقدَّمة من العرض التقديمي المصدر في الفهرس المحدّد في العرض التقديمي الحالي، وتضبط رابط الشريحة على النحو المحدّد في SlideLinkingMode.

إذا كان وضع الرابط هو SlideLinkingMode.LINKED، يمكن تعديل الشريحة المُدرجة لتطابق الشريحة المصدر التي تم تقديمها عند استدعاء Slide.refreshSlide(). ويمكن للمتعاونين الآخرين الاطّلاع على الرابط الذي يؤدي إلى الشريحة المصدر. لا يمكن استخدام SlideLinkingMode.LINKED مع شرائح المصدر من العرض التقديمي الحالي.

// Copy a slide from another presentation, then insert and link it.
var sourcePresentation = SlidesApp.openById('presentationId');
var currentPresentation = SlidesApp.getActivePresentation();
var slide = sourcePresentation.getSlides()[0];
var insertionIndex = 1;
var insertedSlide =
    currentPresentation.insertSlide(
    insertionIndex, slide, SlidesApp.SlideLinkingMode.LINKED);

المعلّمات

الاسم	النوع	الوصف
`insertionIndex`	`Integer`	مؤشر غير صفري يوضح مكان إدراج الشريحة.
`slide`	`Slide`	الشريحة التي سيتم نسخها وإدراجها.
`linkingMode`	`SlideLinkingMode`	وضع الرابط المراد استخدامه.

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

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

التفويض

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

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

`removeEditor(emailAddress)`

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

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

المعلّمات

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

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

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

التفويض

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

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

`removeEditor(user)`

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

المعلّمات

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

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

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

التفويض

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

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

`removeViewer(emailAddress)`

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

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

المعلّمات

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

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

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

التفويض

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

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

`removeViewer(user)`

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

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

المعلّمات

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

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

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

التفويض

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

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

`replaceAllText(findText, replaceText)`

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

المعلّمات

الاسم	النوع	الوصف
`findText`	`String`	النص المطلوب البحث عنه.
`replaceText`	`String`	النص المطلوب استبدال النص المتطابق معه.

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

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

التفويض

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

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

`replaceAllText(findText, replaceText, matchCase)`

استبدال جميع مثيلات مطابقة النص للعثور على النص باستبدال النص.

المعلّمات

الاسم	النوع	الوصف
`findText`	`String`	النص المطلوب البحث عنه.
`replaceText`	`String`	النص المطلوب استبدال النص المتطابق معه.
`matchCase`	`Boolean`	إذا كانت قيمة `true`، ستكون عملية البحث حسّاسة لحالة الأحرف، وإذا كانت `false`، سيكون البحث غير حساس لحالة الأحرف.

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

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

التفويض

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

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

`saveAndClose()`

يحفظ هذا الإعداد Presentation الحالية. تسبّب في انتظار تطبيق التحديثات المعلقة.

تُستدعى الطريقة saveAndClose() تلقائيًا في نهاية تنفيذ النص البرمجي لكل Presentation مفتوحة، حتى إذا تم إنهاء تنفيذ النص البرمجي بسبب خطأ.

لا يمكن تعديل Presentation المُغلق. يمكنك استخدام إحدى الطرق المفتوحة على SlidesApp لإعادة فتح عرض تقديمي معيّن لتعديله.

التفويض

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

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

`setName(name)`

يحدد اسم العرض التقديمي أو عنوانه.

المعلّمات

الاسم	النوع	الوصف
`name`	`String`	الاسم المحدّد لهذا العرض التقديمي.

التفويض

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

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