Class NotesPage

صفحه یادداشت‌ها

یک صفحه یادداشت در یک ارائه.

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

روش‌ها

روش نوع بازگشتی شرح مختصر
get Groups() Group[] لیست اشیاء Group را در صفحه برمی‌گرداند.
get Images() Image[] لیست اشیاء Image موجود در صفحه را برمی‌گرداند.
get Lines() Line[] لیست اشیاء Line را در صفحه برمی‌گرداند.
get Object Id() String شناسه منحصر به فرد صفحه را دریافت می‌کند.
get Page Element By Id(id) Page Element |null Page Element را در صفحه با شناسه داده شده برمی‌گرداند، یا در صورت وجود نداشتن null برمی‌گرداند.
get Page Elements() Page Element[] لیستی از اشیاء Page Element که در صفحه رندر شده‌اند را برمی‌گرداند.
get Placeholder(placeholderType) Page Element |null شیء Page Element جانگهدار را برای یک Placeholder Type مشخص‌شده برمی‌گرداند یا در صورت عدم وجود جانگهدار منطبق، null برمی‌گرداند.
get Placeholder(placeholderType, placeholderIndex) Page Element |null شیء Page Element جانگهدار را برای یک Placeholder Type مشخص شده و یک اندیس جانگهدار برمی‌گرداند، یا در صورت عدم وجود جانگهدار، null را برمی‌گرداند.
get Placeholders() Page Element[] لیستی از اشیاء Page Element که به عنوان placeholder در صفحه قرار دارند را برمی‌گرداند.
get Shapes() Shape[] لیست اشیاء Shape موجود در صفحه را برمی‌گرداند.
get Sheets Charts() Sheets Chart[] لیست اشیاء Sheets Chart را در صفحه برمی‌گرداند.
get Speaker Notes Shape() Shape شکلی که شامل یادداشت‌های گوینده در صفحه است را دریافت می‌کند.
get Tables() Table[] لیست اشیاء Table موجود در صفحه را برمی‌گرداند.
get Videos() Video[] لیست اشیاء Video ) موجود در صفحه را برمی‌گرداند.
get Word Arts() Word Art[] لیست اشیاء Word Art موجود در صفحه را برمی‌گرداند.
replace All Text(findText, replaceText) Integer تمام نمونه‌های متن منطبق با find text را با replace text جایگزین می‌کند.
replace All Text(findText, replaceText, matchCase) Integer تمام نمونه‌های متن منطبق با find text را با replace text جایگزین می‌کند.

مستندات دقیق

get Groups()

لیست اشیاء Group را در صفحه برمی‌گرداند.

بازگشت

Group[]

مجوز

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

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

get Images()

لیست اشیاء Image موجود در صفحه را برمی‌گرداند.

بازگشت

Image[]

مجوز

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

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

get Lines()

لیست اشیاء Line را در صفحه برمی‌گرداند.

بازگشت

Line[]

مجوز

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

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

get Object Id()

شناسه منحصر به فرد صفحه را دریافت می‌کند. شناسه‌های شیء مورد استفاده توسط صفحات و عناصر صفحه، فضای نام یکسانی را به اشتراک می‌گذارند.

بازگشت

String

مجوز

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

  • 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 Elements()

لیستی از اشیاء Page Element که در صفحه رندر شده‌اند را برمی‌گرداند.

بازگشت

Page Element[]

مجوز

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

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

get Placeholder(placeholderType)

شیء Page Element جانگهدار را برای یک Placeholder Type مشخص‌شده برمی‌گرداند یا در صورت عدم وجود جانگهدار منطبق، null برمی‌گرداند.

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

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const placeholder = slide.getPlaceholder(
    SlidesApp.PlaceholderType.CENTERED_TITLE,
);

پارامترها

نام نوع توضیحات
placeholder Type Placeholder Type

بازگشت

Page Element |null

مجوز

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

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

get Placeholder(placeholderType, placeholderIndex)

شیء Page Element جانگهدار را برای یک Placeholder Type مشخص شده و یک اندیس جانگهدار برمی‌گرداند، یا در صورت عدم وجود جانگهدار، null را برمی‌گرداند.

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

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const placeholder = slide.getPlaceholder(
    SlidesApp.PlaceholderType.CENTERED_TITLE,
    0,
);

پارامترها

نام نوع توضیحات
placeholder Type Placeholder Type
placeholder Index Integer

بازگشت

Page Element |null

مجوز

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

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

get Placeholders()

لیستی از اشیاء Page Element که به عنوان placeholder در صفحه قرار دارند را برمی‌گرداند.

const master = SlidesApp.getActivePresentation().getMasters()[0];
Logger.log(
    `Number of placeholders in the master: ${master.getPlaceholders().length}`,
);

بازگشت

Page Element[]

مجوز

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

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

get Shapes()

لیست اشیاء Shape موجود در صفحه را برمی‌گرداند.

بازگشت

Shape[]

مجوز

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

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

get Sheets Charts()

لیست اشیاء Sheets Chart را در صفحه برمی‌گرداند.

بازگشت

Sheets Chart[]

مجوز

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

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

get Speaker Notes Shape()

شکلی که شامل یادداشت‌های گوینده در صفحه است را دریافت می‌کند.

بازگشت

Shape

مجوز

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

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

get Tables()

لیست اشیاء Table موجود در صفحه را برمی‌گرداند.

بازگشت

Table[]

مجوز

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

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

get Videos()

لیست اشیاء Video ) موجود در صفحه را برمی‌گرداند.

بازگشت

Video[]

مجوز

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

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

get Word Arts()

لیست اشیاء Word Art موجود در صفحه را برمی‌گرداند.

بازگشت

Word Art[]

مجوز

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

  • 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