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

المعلمات

الاسم	النوع	الوصف
`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.
const otherPresentation = SlidesApp.openById('presentationId');
const currentPresentation = SlidesApp.getActivePresentation();
const 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.
const sourcePresentation = SlidesApp.openById('presentationId');
const currentPresentation = SlidesApp.getActivePresentation();
const slide = sourcePresentation.getSlides()[0];
const 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|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 إذا لم يكن هناك أي معرّف.

المعلمات

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

الإرجاع

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

المعلمات

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

الإرجاع

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

التفويض

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

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

`insertSlide(insertionIndex, layout)`

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

`insertSlide(insertionIndex, predefinedLayout)`

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

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

المعلمات

الاسم	النوع	الوصف
`insertionIndex`	`Integer`	الفهرس الذي يبدأ من 0 والذي يشير إلى مكان إدراج الشريحة.
`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.
const otherPresentation = SlidesApp.openById('presentationId');
const currentPresentation = SlidesApp.getActivePresentation();
const slide = otherPresentation.getSlides()[0];
const insertionIndex = 1;
currentPresentation.insertSlide(insertionIndex, slide);

المعلمات

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

المعلمات

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

Class Presentation تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

الطُرق

مستندات تفصيلية

addEditor(emailAddress)

المعلمات

الإرجاع

التفويض

addEditor(user)

المعلمات

الإرجاع

التفويض

addEditors(emailAddresses)

المعلمات

الإرجاع

التفويض

addViewer(emailAddress)

المعلمات

الإرجاع

التفويض

addViewer(user)

المعلمات

الإرجاع

التفويض

addViewers(emailAddresses)

المعلمات

الإرجاع

التفويض

appendSlide()

الإرجاع

التفويض

appendSlide(layout)

المعلمات

الإرجاع

التفويض

appendSlide(predefinedLayout)

المعلمات

الإرجاع

التفويض

appendSlide(slide)

المعلمات

الإرجاع

التفويض

appendSlide(slide, linkingMode)

المعلمات

الإرجاع

التفويض

getEditors()

الإرجاع

التفويض

getId()

الإرجاع

التفويض

getLayouts()

الإرجاع

التفويض

getMasters()

الإرجاع

التفويض

getName()

الإرجاع

التفويض

getNotesMaster()

الإرجاع

التفويض

getNotesPageHeight()

الإرجاع

التفويض

getNotesPageWidth()

الإرجاع

التفويض

getPageElementById(id)

المعلمات

الإرجاع

التفويض

getPageHeight()

الإرجاع

التفويض

getPageWidth()

الإرجاع

التفويض

Class Presentation

`addEditor(emailAddress)`

`addEditor(user)`

`addEditors(emailAddresses)`

`addViewer(emailAddress)`

`addViewer(user)`

`addViewers(emailAddresses)`

`appendSlide()`

`appendSlide(layout)`

`appendSlide(predefinedLayout)`

`appendSlide(slide)`

`appendSlide(slide, linkingMode)`

`getEditors()`

`getId()`

`getLayouts()`

`getMasters()`

`getName()`

`getNotesMaster()`

`getNotesPageHeight()`

`getNotesPageWidth()`

`getPageElementById(id)`

`getPageHeight()`

`getPageWidth()`

`getSelection()`

`getSlideById(id)`

`getSlides()`

`getUrl()`

`getViewers()`

`insertSlide(insertionIndex)`

`insertSlide(insertionIndex, layout)`

`insertSlide(insertionIndex, predefinedLayout)`

`insertSlide(insertionIndex, slide)`

`insertSlide(insertionIndex, slide, linkingMode)`

`removeEditor(emailAddress)`

`removeEditor(user)`

`removeViewer(emailAddress)`

`removeViewer(user)`

`replaceAllText(findText, replaceText)`

`replaceAllText(findText, replaceText, matchCase)`

`saveAndClose()`

`setName(name)`