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