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 نام یا عنوان ارائه را تنظیم می‌کند.

مستندات دقیق

add Editor(emailAddress)

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

پارامترها

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

بازگشت

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

مجوز

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

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

add Editor(user)

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

پارامترها

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

بازگشت

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

مجوز

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

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

add Editors(emailAddresses)

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

پارامترها

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

بازگشت

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

مجوز

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

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

add Viewer(emailAddress)

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

پارامترها

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

بازگشت

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

مجوز

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

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

add Viewer(user)

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

پارامترها

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

بازگشت

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

مجوز

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

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

add Viewers(emailAddresses)

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

پارامترها

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

بازگشت

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

مجوز

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

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

append Slide()

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

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

بازگشت

Slide - اسلاید جدیدی که اضافه می‌شود.

مجوز

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

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

append Slide(layout)

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

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

پارامترها

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

بازگشت

Slide - اسلاید جدیدی که اضافه می‌شود.

مجوز

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

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

append Slide(predefinedLayout)

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

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

پارامترها

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

بازگشت

Slide - اسلاید جدیدی که اضافه می‌شود.

مجوز

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

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

append Slide(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

append Slide(slide, linkingMode)

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

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

اگر حالت پیوند Slide Linking Mode.LINKED باشد، اسلاید پیوست شده می‌تواند هنگام فراخوانی Slide.refreshSlide() با اسلاید منبع ارائه شده مطابقت داشته باشد. سایر همکاران می‌توانند پیوند به اسلاید منبع را ببینند. Slide Linking Mode.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

get Editors()

لیست ویراستاران این Presentation دریافت می‌کند.

بازگشت

User[] — آرایه‌ای از کاربران با اجازه ویرایش.

مجوز

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

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

get Id()

شناسه منحصر به فرد ارائه را دریافت می‌کند. شناسه ارائه با استفاده از Slides App.openById() برای باز کردن یک نمونه ارائه خاص استفاده می‌شود.

بازگشت

String — شناسه‌ی این ارائه.

مجوز

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

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

get Layouts()

طرح‌بندی‌های موجود در ارائه را دریافت می‌کند.

بازگشت

Layout[] — فهرست طرح‌بندی‌های موجود در این ارائه.

مجوز

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

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

get Masters()

در ارائه، استاد می‌شود.

بازگشت

Master[] — فهرست استادان در این ارائه.

مجوز

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

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

get Name()

نام یا عنوان ارائه را دریافت می‌کند.

بازگشت

String — عنوان این ارائه.

مجوز

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

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

get Notes Master()

یادداشت‌های ارائه را به طور کامل دریافت می‌کند.

بازگشت

Notes Master — یادداشت‌های اصلی ارائه.

مجوز

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

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

get Notes Page Height()

ارتفاع صفحه یادداشت‌های اصلی و صفحات یادداشت‌ها در ارائه را بر حسب نقطه دریافت می‌کند. همه آنها ارتفاع صفحه یکسانی دارند.

بازگشت

Number — ارتفاع صفحه یادداشت‌ها بر حسب نقطه.

مجوز

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

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

get Notes Page Width()

عرض صفحه یادداشت‌های اصلی و صفحات یادداشت‌ها در ارائه را بر حسب نقطه دریافت می‌کند. همه آنها عرض صفحه یکسانی دارند.

بازگشت

Number — عرض صفحه یادداشت‌ها بر حسب نقطه.

مجوز

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

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

get Page Element By Id(id)

Page Element را با شناسه داده شده برمی‌گرداند، یا در صورت وجود نداشتن null برمی‌گرداند.

پارامترها

نام نوع توضیحات
id String شناسه عنصر صفحه‌ای که بازیابی می‌شود.

بازگشت

Page Element |null — عنصر صفحه با شناسه داده شده.

مجوز

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

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

get Page Height()

ارتفاع صفحه اسلایدها، طرح‌بندی‌ها و فایل‌های اصلی در ارائه را بر حسب واحد دریافت می‌کند. همه آنها ارتفاع صفحه یکسانی دارند.

بازگشت

Number — ارتفاع صفحه بر حسب نقطه.

مجوز

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

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

get Page Width()

عرض صفحه اسلایدها، طرح‌بندی‌ها و فایل‌های اصلی در ارائه را بر حسب واحد دریافت می‌کند. همه آنها عرض صفحه یکسانی دارند.

بازگشت

Number — عرض صفحه بر حسب نقطه.

مجوز

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

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

get Selection()

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

توجه داشته باشید که انتخاب برگردانده شده، انتخاب مؤثر فعلی است. همانطور که اسکریپت تغییرات مختلفی را در ارائه انجام می‌دهد، انتخاب برای در نظر گرفتن آنها تبدیل می‌شود. به عنوان مثال، اگر دو شکل 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

get Slide By Id(id)

Slide را با شناسه‌ی داده شده برمی‌گرداند، یا در صورت وجود نداشتن null برمی‌گرداند.

پارامترها

نام نوع توضیحات
id String شناسه اسلایدی که بازیابی می‌شود.

بازگشت

Slide |null — اسلایدی با شناسه‌ی داده شده.

مجوز

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

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

get Slides()

اسلایدهای ارائه را دریافت می‌کند.

بازگشت

Slide[] — فهرست اسلایدهای این ارائه.

مجوز

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

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

get Url()

آدرس اینترنتی (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

get Viewers()

لیست بینندگان و نظردهندگان این Presentation را دریافت می‌کند.

بازگشت

User[] — آرایه‌ای از کاربران با مجوز مشاهده یا نظر دادن.

مجوز

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

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

insert Slide(insertionIndex)

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

insert Slide(insertionIndex, layout)

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

insert Slide(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

insert Slide(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

insert Slide(insertionIndex, slide, linkingMode)

یک کپی از Slide ارائه شده از ارائه منبع را در فهرست مشخص شده در ارائه فعلی وارد می‌کند و پیوند اسلاید را همانطور که توسط Slide Linking Mode مشخص شده است، تنظیم می‌کند.

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

اگر حالت پیوند Slide Linking Mode.LINKED باشد، اسلاید درج شده می‌تواند هنگام فراخوانی Slide.refreshSlide() با اسلاید منبع ارائه شده مطابقت داشته باشد. سایر همکاران می‌توانند پیوند به اسلاید منبع را ببینند. Slide Linking Mode.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

remove Editor(emailAddress)

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

remove Editor(user)

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

remove Viewer(emailAddress)

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

remove Viewer(user)

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

replace All Text(findText, replaceText)

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

پارامترها

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

بازگشت

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

مجوز

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

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

replace All Text(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

save And Close()

Presentation فعلی را ذخیره می‌کند. باعث می‌شود به‌روزرسانی‌های در حال انتظار پاک شده و اعمال شوند.

متد save And Close() به طور خودکار در پایان اجرای اسکریپت برای هر Presentation باز فراخوانی می‌شود، حتی اگر اجرای اسکریپت با خطا خاتمه یابد.

یک Presentation بسته قابل ویرایش نیست. از یکی از روش‌های باز کردن در Slides App برای بازگشایی مجدد یک ارائه مشخص جهت ویرایش استفاده کنید.

مجوز

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

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

set Name(name)

نام یا عنوان ارائه را تنظیم می‌کند.

پارامترها

نام نوع توضیحات
name String نامی که برای این ارائه تعیین می‌شود.

مجوز

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

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