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)

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

پارامترها

نام تایپ کنید توضیحات
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)

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

پارامترها

نام تایپ کنید توضیحات
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 صفر باشد، مستر اسلاید اول.
  • استاد اول در ارائه، در صورت عدم وجود اسلاید.

پارامترها

نام تایپ کنید توضیحات
insertionIndex Integer شاخص مبتنی بر صفر که محل درج اسلاید را نشان می دهد.

بازگشت

Slide - اسلاید جدیدی که درج شده است.

مجوز

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

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

insertSlide(insertionIndex, layout)

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

  • استاد اسلاید قبلی.
  • اگر InsertionIndex صفر باشد، مستر اسلاید اول.
  • استاد اول در ارائه، در صورت عدم وجود اسلاید.

پارامترها

نام تایپ کنید توضیحات
insertionIndex Integer شاخص مبتنی بر صفر که محل درج اسلاید را نشان می دهد.
layout Layout طرح مورد استفاده برای اسلاید جدید؛ باید در استاد فعلی وجود داشته باشد.

بازگشت

Slide - اسلاید جدیدی که درج شده است.

مجوز

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

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

insertSlide(insertionIndex, predefinedLayout)

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

  • استاد اسلاید قبلی.
  • اگر InsertionIndex صفر باشد، مستر اسلاید اول.
  • استاد اول در ارائه، در صورت عدم وجود اسلاید.

پارامترها

نام تایپ کنید توضیحات
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)

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

برای فایل‌های 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