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 جایگزین می‌کند.

مستندات دقیق

getGroups()

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

بازگشت

Group[]

مجوز

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

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

getImages()

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

بازگشت

Image[]

مجوز

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

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

getLines()

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

بازگشت

Line[]

مجوز

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

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

getObjectId()

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

بازگشت

String

مجوز

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

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

getPageElementById(id)

PageElement موجود در صفحه با شناسه (ID) داده شده را برمی‌گرداند، یا در صورت وجود نداشتن null برمی‌گرداند.

پارامترها

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

بازگشت

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

مجوز

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

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

getPageElements()

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

بازگشت

PageElement[]

مجوز

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

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

getPlaceholder(placeholderType)

شیء PageElement مربوط به یک PlaceholderType مشخص شده را برمی‌گرداند یا در صورت عدم وجود placeholder منطبق، null برمی‌گرداند.

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

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

پارامترها

نام نوع توضیحات
placeholder Type Placeholder Type نوع متغیری که باید مطابقت داشته باشد.

بازگشت

PageElement |null — عنصر صفحه جای‌نگهدار، یا اگر هیچ موردی یافت نشد، null .

مجوز

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

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

getPlaceholder(placeholderType, placeholderIndex)

شیء PageElement مربوط به یک PlaceholderType و یک اندیس placeholder مشخص شده را برمی‌گرداند، یا در صورت عدم وجود placeholder، null برمی‌گرداند.

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

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

پارامترها

نام نوع توضیحات
placeholder Type Placeholder Type نوع متغیری که باید مطابقت داشته باشد.
placeholder Index Integer اندیسِ جانگهدار (placeholder) که باید تطبیق داده شود.

بازگشت

PageElement |null — عنصر صفحه جای‌نگهدار، یا اگر هیچ موردی یافت نشد، null .

مجوز

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

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

getPlaceholders()

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

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

بازگشت

PageElement[]

مجوز

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

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

getShapes()

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

بازگشت

Shape[]

مجوز

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

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

getSheetsCharts()

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

بازگشت

SheetsChart[]

مجوز

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

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

getSpeakerNotesShape()

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

بازگشت

Shape

مجوز

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

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

getTables()

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

بازگشت

Table[]

مجوز

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

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

getVideos()

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

بازگشت

Video[]

مجوز

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

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

getWordArts()

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

بازگشت

WordArt[]

مجوز

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

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

replaceAllText(findText, replaceText)

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

پارامترها

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

بازگشت

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

مجوز

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

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

replaceAllText(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