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 اسلایدی را به انتهای ارائه اضافه می‌کند. طرح‌بندی از پیش تعریف‌شده 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 Page Element را با شناسه داده شده برمی‌گرداند، یا اگر هیچ کدام وجود نداشته باشد، null .
get Page Height() Number ارتفاع صفحه اسلایدها، طرح‌بندی‌ها و مسترها را در ارائه به صورت امتیاز می‌گیرد.
get Page Width() Number عرض صفحه اسلایدها، طرح‌بندی‌ها و مسترها را در ارائه به صورت نقاط دریافت می‌کند.
get Selection() Selection انتخاب کاربر را در ارائه فعال دریافت می کند.
get Slide By Id(id) Slide Slide را با شناسه داده شده برمی‌گرداند، یا اگر هیچ کدام وجود نداشته باشد، null .
get Slides() Slide[] اسلایدهای ارائه را دریافت می کند.
get Url() String URL برای دسترسی به این ارائه را بازیابی می کند.
get Viewers() User[] لیست بینندگان و نظر دهندگان را برای این Presentation دریافت می کند.
insert Slide(insertionIndex) Slide یک اسلاید را در نمایه مشخص شده در ارائه با استفاده از Predefined Layout.BLANK درج می کند. طرح بندی از پیش تعریف شده 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 همه نمونه‌های متنی که متن یافتن را با متن جایگزین مطابقت دارد جایگزین می‌کند.
replace All Text(findText, replaceText, matchCase) Integer همه نمونه‌های متنی که متن یافتن را با متن جایگزین مطابقت دارد جایگزین می‌کند.
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 اسلایدی را به انتهای ارائه اضافه می‌کند. طرح‌بندی از پیش تعریف‌شده BLANK بر اساس اصلی فعلی. استاد فعلی یکی از موارد زیر است:

  • استاد آخرین اسلاید فعلی.
  • استاد اول در ارائه، در صورت عدم وجود اسلاید.

بازگشت

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 باشد.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 - عنصر صفحه با شناسه داده شده.

مجوز

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

  • 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 .

مجوز

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

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

get Slide By Id(id)

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

پارامترها

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

بازگشت

Slide - اسلاید با شناسه داده شده.

مجوز

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

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

insert Slide(insertionIndex, layout)

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

insert Slide(insertionIndex, predefinedLayout)

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

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

پارامترها

نام تایپ کنید توضیحات
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 باشد.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 در یک درایو مشترک است که کاربر می تواند دسترسی داشته باشد.

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

پارامترها

نام تایپ کنید توضیحات
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 در یک درایو مشترک است که کاربر می تواند دسترسی داشته باشد.

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

پارامترها

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

بازگشت

Presentation - این Presentation ، برای زنجیر کردن.

مجوز

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

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

remove Viewer(emailAddress)

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

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

پارامترها

نام تایپ کنید توضیحات
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 در یک درایو مشترک است که کاربر می تواند دسترسی داشته باشد.

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

پارامترها

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

بازگشت

Presentation - این Presentation برای زنجیر کردن.

مجوز

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

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

replace All Text(findText, replaceText)

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

پارامترها

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