Class Presentation

ارائه

یک ارائه.

روش‌ها

روش نوع بازگشتی شرح مختصر
add Editor(emailAddress) Presentation کاربر داده شده را به لیست ویرایشگران Presentation اضافه می‌کند.
add Editor(user) Presentation کاربر داده شده را به لیست ویرایشگران Presentation اضافه می‌کند.
add Editors(emailAddresses) Presentation آرایه‌ی داده شده از کاربران را به لیست ویرایشگرهای Presentation اضافه می‌کند.
add Viewer(emailAddress) Presentation کاربر داده شده را به لیست بینندگان Presentation اضافه می‌کند.
add Viewer(user) Presentation کاربر داده شده را به لیست بینندگان Presentation اضافه می‌کند.
add Viewers(emailAddresses) Presentation آرایه‌ی داده شده از کاربران را به لیست بینندگان Presentation اضافه می‌کند.
append Slide() Slide با استفاده از طرح از پیش تعریف شده‌ی Predefined Layout.BLANK بر اساس فایل اصلی فعلی، یک اسلاید را به انتهای ارائه اضافه می‌کند.
append Slide(layout) Slide با استفاده از طرح‌بندی مشخص‌شده بر اساس فایل اصلی فعلی، یک اسلاید را به انتهای ارائه اضافه می‌کند.
append Slide(predefinedLayout) Slide با استفاده از طرح‌بندی از پیش تعریف‌شده‌ی مشخص‌شده بر اساس فایل اصلی فعلی، یک اسلاید را به انتهای ارائه اضافه می‌کند.
append Slide(slide) Slide یک کپی از Slide ارائه شده را به انتهای ارائه اضافه می‌کند.
append Slide(slide, linkingMode) Slide یک کپی از Slide ارائه شده از ارائه منبع را به انتهای ارائه فعلی اضافه می‌کند و لینک اسلاید را همانطور که توسط Slide Linking Mode مشخص شده است، تنظیم می‌کند.
get Editors() User[] لیست ویراستاران این Presentation دریافت می‌کند.
get Id() String شناسه منحصر به فرد ارائه را دریافت می‌کند.
get Layouts() Layout[] طرح‌بندی‌های موجود در ارائه را دریافت می‌کند.
get Masters() Master[] در ارائه، استاد می‌شود.
get Name() String نام یا عنوان ارائه را دریافت می‌کند.
get Notes Master() Notes Master یادداشت‌های ارائه را به طور کامل دریافت می‌کند.
get Notes Page Height() Number ارتفاع صفحه یادداشت‌های اصلی و صفحات یادداشت‌ها را در ارائه بر حسب نقطه دریافت می‌کند.
get Notes Page Width() Number عرض صفحه یادداشت‌های اصلی و صفحات یادداشت‌ها در ارائه را بر حسب نقطه دریافت می‌کند.
get Page Element By Id(id) Page Element |null Page Element را با شناسه داده شده برمی‌گرداند، یا در صورت وجود نداشتن null برمی‌گرداند.
get Page Height() Number ارتفاع صفحه اسلایدها، طرح‌بندی‌ها و صفحات اصلی در ارائه را بر حسب واحد نقطه دریافت می‌کند.
get Page Width() Number عرض صفحه اسلایدها، طرح‌بندی‌ها و صفحات اصلی در ارائه را بر حسب نقطه دریافت می‌کند.
get Selection() Selection |null انتخاب کاربر را در ارائه فعال دریافت می‌کند.
get Slide By Id(id) Slide |null Slide را با شناسه‌ی داده شده برمی‌گرداند، یا در صورت وجود نداشتن null برمی‌گرداند.
get Slides() Slide[] اسلایدهای ارائه را دریافت می‌کند.
get Url() String آدرس اینترنتی (URL) دسترسی به این ارائه را بازیابی می‌کند.
get Viewers() User[] لیست بینندگان و نظردهندگان این Presentation را دریافت می‌کند.
insert Slide(insertionIndex) Slide با استفاده از طرح از پیش Predefined Layout.BLANK بر اساس فایل اصلی فعلی، یک اسلاید را در فهرست مشخص شده در ارائه درج می‌کند.
insert Slide(insertionIndex, layout) Slide با استفاده از طرح‌بندی مشخص‌شده بر اساس فایل اصلی فعلی، اسلایدی را در فهرست مشخص‌شده در ارائه درج می‌کند.
insert Slide(insertionIndex, predefinedLayout) Slide با استفاده از طرح‌بندی از پیش تعریف‌شده‌ی مشخص‌شده بر اساس فایل اصلی فعلی، یک اسلاید را در فهرست مشخص‌شده در ارائه درج می‌کند.
insert Slide(insertionIndex, slide) Slide یک کپی از Slide ارائه شده را در محل مشخص شده در ارائه درج می‌کند.
insert Slide(insertionIndex, slide, linkingMode) Slide یک کپی از Slide ارائه شده از ارائه منبع را در فهرست مشخص شده در ارائه فعلی وارد می‌کند و پیوند اسلاید را همانطور که توسط Slide Linking Mode مشخص شده است، تنظیم می‌کند.
remove Editor(emailAddress) Presentation کاربر داده شده را از لیست ویرایشگران Presentation حذف می‌کند.
remove Editor(user) Presentation کاربر داده شده را از لیست ویرایشگران Presentation حذف می‌کند.
remove Viewer(emailAddress) Presentation کاربر داده شده را از لیست بینندگان و نظردهندگان Presentation حذف می‌کند.
remove Viewer(user) Presentation کاربر داده شده را از لیست بینندگان و نظردهندگان Presentation حذف می‌کند.
replace All Text(findText, replaceText) Integer تمام نمونه‌های متن منطبق با find text را با replace text جایگزین می‌کند.
replace All Text(findText, replaceText, matchCase) Integer تمام نمونه‌های متن منطبق با find text را با replace text جایگزین می‌کند.
save And Close() void Presentation فعلی را ذخیره می‌کند.
set Name(name) void نام یا عنوان ارائه را تنظیم می‌کند.

مستندات دقیق

addEditor(emailAddress)

کاربر داده شده را به لیست ویرایشگران Presentation اضافه می‌کند. اگر کاربر از قبل در لیست بینندگان باشد، این متد کاربر را از لیست بینندگان خارج می‌کند.

پارامترها

نام نوع توضیحات
email Address String آدرس ایمیل کاربر برای اضافه کردن.

بازگشت

Presentation — این Presentation ، برای زنجیره‌سازی.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

addEditor(user)

کاربر داده شده را به لیست ویرایشگران Presentation اضافه می‌کند. اگر کاربر از قبل در لیست بینندگان باشد، این متد کاربر را از لیست بینندگان خارج می‌کند.

پارامترها

نام نوع توضیحات
user User نمایشی از کاربر برای اضافه کردن.

بازگشت

Presentation — این Presentation ، برای زنجیره‌سازی.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

addEditors(emailAddresses)

آرایه داده شده از کاربران را به لیست ویرایشگران Presentation اضافه می‌کند. اگر هر یک از کاربران از قبل در لیست بینندگان بودند، این متد آنها را از لیست بینندگان خارج می‌کند.

پارامترها

نام نوع توضیحات
email Addresses String[] آرایه‌ای از آدرس‌های ایمیل کاربران برای اضافه کردن.

بازگشت

Presentation — این Presentation ، برای زنجیره‌سازی.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

addViewer(emailAddress)

کاربر داده شده را به لیست بینندگان Presentation اضافه می‌کند. اگر کاربر از قبل در لیست ویرایشگران باشد، این متد هیچ تاثیری ندارد.

پارامترها

نام نوع توضیحات
email Address String آدرس ایمیل کاربر برای اضافه کردن.

بازگشت

Presentation — این Presentation ، برای زنجیره‌سازی.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

addViewer(user)

کاربر داده شده را به لیست بینندگان Presentation اضافه می‌کند. اگر کاربر از قبل در لیست ویرایشگران باشد، این متد هیچ تاثیری ندارد.

پارامترها

نام نوع توضیحات
user User نمایشی از کاربر برای اضافه کردن.

بازگشت

Presentation — این Presentation ، برای زنجیره‌سازی.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

addViewers(emailAddresses)

آرایه‌ی داده شده از کاربران را به لیست بینندگان Presentation اضافه می‌کند. اگر هر یک از کاربران از قبل در لیست ویرایشگران بودند، این متد هیچ تاثیری روی آنها ندارد.

پارامترها

نام نوع توضیحات
email Addresses 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)

یک اسلاید را با استفاده از طرح‌بندی از پیش تعریف‌شده‌ی مشخص‌شده بر اساس استاد فعلی، به انتهای ارائه اضافه می‌کند. استاد فعلی یکی از موارد زیر است:

  • استادِ آخرین اسلایدِ فعلی.
  • استاد اول در ارائه، اگر اسلایدی وجود نداشته باشد.

پارامترها

نام نوع توضیحات
predefined Layout Predefined Layout طرح‌بندی از پیش تعریف‌شده برای استفاده در اسلاید جدید؛ این طرح‌بندی باید در فایل اصلی فعلی وجود داشته باشد.

بازگشت

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 اسلایدی که قرار است کپی، ضمیمه و لینک شود.
linking Mode Slide Linking Mode حالت پیوند مورد استفاده.

بازگشت

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 با شناسه (ID) داده شده برمی‌گرداند، یا در صورت وجود نداشتن 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 بر اساس master فعلی، یک اسلاید را در فهرست مشخص شده در ارائه درج می‌کند. master فعلی یکی از موارد زیر است:

  • استاد اسلاید قبلی.
  • اگر مقدار insertionIndex برابر با صفر باشد، اسلاید اصلی (master) اولین اسلاید.
  • استاد اول در ارائه، اگر اسلایدی وجود نداشته باشد.

پارامترها

نام نوع توضیحات
insertion Index Integer اندیس مبتنی بر صفر که نشان می‌دهد اسلاید را کجا قرار دهید.

بازگشت

Slide — اسلاید جدیدی که درج می‌شود.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

insertSlide(insertionIndex, layout)

با استفاده از طرح‌بندی مشخص‌شده بر اساس استاد فعلی، اسلایدی را در فهرست مشخص‌شده در ارائه درج می‌کند. استاد فعلی یکی از موارد زیر است:

  • استاد اسلاید قبلی.
  • اگر مقدار insertionIndex برابر با صفر باشد، اسلاید اصلی (master) اولین اسلاید.
  • استاد اول در ارائه، اگر اسلایدی وجود نداشته باشد.

پارامترها

نام نوع توضیحات
insertion Index Integer اندیس مبتنی بر صفر که نشان می‌دهد اسلاید را کجا قرار دهید.
layout Layout طرح‌بندی مورد استفاده برای اسلاید جدید؛ این طرح‌بندی باید در فایل اصلی فعلی وجود داشته باشد.

بازگشت

Slide — اسلاید جدیدی که درج می‌شود.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

insertSlide(insertionIndex, predefinedLayout)

با استفاده از طرح‌بندی از پیش تعریف‌شده‌ی مشخص‌شده بر اساس استاد فعلی، اسلایدی را در فهرست مشخص‌شده در ارائه درج می‌کند. استاد فعلی یکی از موارد زیر است:

  • استاد اسلاید قبلی.
  • اگر مقدار insertionIndex برابر با صفر باشد، اسلاید اصلی (master) اولین اسلاید.
  • استاد اول در ارائه، اگر اسلایدی وجود نداشته باشد.

پارامترها

نام نوع توضیحات
insertion Index Integer اندیس مبتنی بر صفر که نشان می‌دهد اسلاید را کجا قرار دهید.
predefined Layout Predefined Layout طرح‌بندی از پیش تعریف‌شده برای استفاده در اسلاید جدید؛ این طرح‌بندی باید در فایل اصلی فعلی وجود داشته باشد.

بازگشت

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);

پارامترها

نام نوع توضیحات
insertion Index 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.
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,
);

پارامترها

نام نوع توضیحات
insertion Index Integer اندیس مبتنی بر صفر که نشان می‌دهد اسلاید را کجا قرار دهید.
slide Slide اسلایدی که قرار است کپی و درج شود.
linking Mode Slide Linking Mode حالت پیوند مورد استفاده.

بازگشت

Slide — اسلاید جدید.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

removeEditor(emailAddress)

کاربر مورد نظر را از فهرست ویرایشگران Presentation حذف می‌کند. این روش، دسترسی کاربران به Presentation را در صورتی که به دسته‌ای از کاربران با دسترسی عمومی تعلق داشته باشند، مسدود نمی‌کند - برای مثال، اگر Presentation با کل دامنه کاربر به اشتراک گذاشته شده باشد، یا اگر Presentation در یک درایو مشترک باشد که کاربر می‌تواند به آن دسترسی داشته باشد.

برای فایل‌های درایو، این کار کاربر را از فهرست مشاهده‌کنندگان نیز حذف می‌کند.

پارامترها

نام نوع توضیحات
email Address String آدرس ایمیل کاربر برای حذف.

بازگشت

Presentation — این Presentation ، برای زنجیره‌سازی.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

removeEditor(user)

کاربر مورد نظر را از فهرست ویرایشگران Presentation حذف می‌کند. این روش، دسترسی کاربران به Presentation را در صورتی که به دسته‌ای از کاربران با دسترسی عمومی تعلق داشته باشند، مسدود نمی‌کند - برای مثال، اگر Presentation با کل دامنه کاربر به اشتراک گذاشته شده باشد، یا اگر Presentation در یک درایو مشترک باشد که کاربر می‌تواند به آن دسترسی داشته باشد.

برای فایل‌های درایو، این کار کاربر را از فهرست مشاهده‌کنندگان نیز حذف می‌کند.

پارامترها

نام نوع توضیحات
user User نماینده‌ای از کاربر که باید حذف شود.

بازگشت

Presentation — این Presentation ، برای زنجیره‌سازی.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

removeViewer(emailAddress)

کاربر داده شده را از فهرست بینندگان و نظردهندگان Presentation حذف می‌کند. این روش در صورتی که کاربر ویرایشگر باشد، نه بیننده یا نظردهنده، هیچ تاثیری ندارد. این روش همچنین دسترسی کاربران به Presentation را در صورتی که به دسته‌ای از کاربران با دسترسی عمومی تعلق داشته باشند، مسدود نمی‌کند - برای مثال، اگر Presentation با کل دامنه کاربر به اشتراک گذاشته شده باشد، یا اگر Presentation در یک درایو مشترک باشد که کاربر می‌تواند به آن دسترسی داشته باشد.

برای فایل‌های درایو، این کار کاربر را از فهرست ویرایشگرها نیز حذف می‌کند.

پارامترها

نام نوع توضیحات
email Address String آدرس ایمیل کاربر برای حذف.

بازگشت

Presentation — این Presentation برای زنجیره‌سازی.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

removeViewer(user)

کاربر داده شده را از فهرست بینندگان و نظردهندگان Presentation حذف می‌کند. این روش در صورتی که کاربر ویرایشگر باشد، نه بیننده، هیچ تاثیری ندارد. این روش همچنین دسترسی کاربران به Presentation را در صورتی که به دسته‌ای از کاربران با دسترسی عمومی تعلق داشته باشند، مسدود نمی‌کند - برای مثال، اگر Presentation با کل دامنه کاربر به اشتراک گذاشته شده باشد، یا اگر Presentation در یک درایو مشترک باشد که کاربر می‌تواند به آن دسترسی داشته باشد.

برای فایل‌های درایو، این کار کاربر را از فهرست ویرایشگرها نیز حذف می‌کند.

پارامترها

نام نوع توضیحات
user User نماینده‌ای از کاربر که باید حذف شود.

بازگشت

Presentation — این Presentation برای زنجیره‌سازی.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

replaceAllText(findText, replaceText)

تمام نمونه‌های متن منطبق با find text را با متن جایگزین جایگزین می‌کند. جستجو به حروف کوچک و بزرگ حساس نیست.

پارامترها

نام نوع توضیحات
find Text String متنی که باید پیدا شود.
replace Text String متنی که قرار است جایگزین متن تطبیق داده شده شود.

بازگشت

Integer - تعداد تکرارها تغییر کرد.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

replaceAllText(findText, replaceText, matchCase)

تمام نمونه‌های متن منطبق با find text را با replace text جایگزین می‌کند.

پارامترها

نام نوع توضیحات
find Text String متنی که باید پیدا شود.
replace Text String متنی که قرار است جایگزین متن تطبیق داده شده شود.
match Case 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