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

المَعلمات

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

استرجاع الكرة

Presentation - جهاز Presentation هذا للسلاسل

التفويض

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

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

`addEditor(user)`

المَعلمات

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

استرجاع الكرة

Presentation - جهاز Presentation هذا للسلاسل

التفويض

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

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

`addEditors(emailAddresses)`

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

المَعلمات

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

استرجاع الكرة

Presentation - جهاز Presentation هذا للسلاسل

التفويض

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

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

`addViewer(emailAddress)`

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

المَعلمات

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

استرجاع الكرة

Presentation - جهاز Presentation هذا للسلاسل

التفويض

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

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

`addViewer(user)`

المَعلمات

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

استرجاع الكرة

Presentation - جهاز Presentation هذا للسلاسل

التفويض

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

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

`addViewers(emailAddresses)`

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

المَعلمات

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

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

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

المَعلمات

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

استرجاع الكرة

Slide - الشريحة الجديدة المُلحقة

التفويض

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

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

`appendSlide(predefinedLayout)`

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

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

المَعلمات

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

المَعلمات

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

المَعلمات

الاسم	Type	الوصف
`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 في حال عدم توفّره.

المَعلمات

الاسم	Type	الوصف
`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 في حال عدم توفّره.

المَعلمات

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

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

المَعلمات

الاسم	Type	الوصف
`insertionIndex`	`Integer`	فهرس مستند إلى صفر يشير إلى مكان إدراج الشريحة.

استرجاع الكرة

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

التفويض

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

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

`insertSlide(insertionIndex, layout)`

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

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

المَعلمات

الاسم	Type	الوصف
`insertionIndex`	`Integer`	فهرس مستند إلى صفر يشير إلى مكان إدراج الشريحة.
`layout`	`Layout`	التخطيط المراد استخدامه للشريحة الجديدة؛ يجب أن يكون موجودًا في الشريحة الرئيسية الحالية.

استرجاع الكرة

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

التفويض

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

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

`insertSlide(insertionIndex, predefinedLayout)`

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

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

المَعلمات

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

المَعلمات

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

المَعلمات

الاسم	Type	الوصف
`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، سيؤدي هذا أيضًا إلى إزالة المستخدم من قائمة العارضين.

المَعلمات

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

استرجاع الكرة

Presentation - جهاز Presentation هذا للسلاسل

التفويض

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

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

`removeEditor(user)`

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

المَعلمات

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

استرجاع الكرة

Presentation - جهاز Presentation هذا للسلاسل

التفويض

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

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

`removeViewer(emailAddress)`

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

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

المَعلمات

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

استرجاع الكرة

Presentation - جهاز Presentation هذا للسلاسل

التفويض

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

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

`removeViewer(user)`

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

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

المَعلمات

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

استرجاع الكرة

Presentation - جهاز Presentation هذا للسلاسل

التفويض

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

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

`replaceAllText(findText, replaceText)`

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

المَعلمات

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

استرجاع الكرة

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

التفويض

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

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

`replaceAllText(findText, replaceText, matchCase)`

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

المَعلمات

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

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

المَعلمات

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

التفويض

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

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