ارائه.
مواد و روش ها
روش | نوع برگشت | توضیح مختصر |
---|---|---|
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()
getMasters()
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()
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