تمت ترجمة هذه الصفحة بواسطة 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 مع عنوان URL للمستخدم النطاق بالكامل، أو إذا كان 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