Class Page

صفحه

یک صفحه در یک ارائه

روش ها

روش نوع برگشت شرح مختصر
as Layout() Layout صفحه را به صورت طرح بندی برمی گرداند.
as Master() Master صفحه را به عنوان اصلی برمی گرداند.
as Slide() Slide صفحه را به صورت اسلاید برمی گرداند.
get Background() Page Background پس زمینه صفحه را دریافت می کند.
get Color Scheme() Color Scheme Color Scheme مرتبط با صفحه را دریافت می کند.
get Groups() Group[] فهرست اشیاء Group را در صفحه برمی گرداند.
get Images() Image[] لیست اشیاء Image را در صفحه برمی گرداند.
get Lines() Line[] لیست اشیاء Line را در صفحه برمی گرداند.
get Object Id() String شناسه منحصر به فرد صفحه را دریافت می کند.
get Page Element By Id(id) Page Element Page Element را در صفحه با شناسه داده شده برمی گرداند، یا اگر هیچ کدام وجود نداشته باشد، null .
get Page Elements() Page Element[] لیستی از اشیاء Page Element ارائه شده در صفحه را برمی گرداند.
get Page Type() Page Type نوع صفحه را دریافت می کند.
get Placeholder(placeholderType) Page Element شیء Page Element مکان نگهدار را برای یک Placeholder Type مشخص شده برمی گرداند یا اگر جای جای منطبقی وجود نداشته باشد، null .
get Placeholder(placeholderType, placeholderIndex) Page Element شیء Page Element نگهدارنده را برای یک Placeholder Type مشخص و یک شاخص مکان‌نما برمی‌گرداند، یا اگر جای‌بان وجود نداشته باشد، null .
get Placeholders() Page Element[] فهرست اشیاء Page Element نگهدارنده در صفحه را برمی گرداند.
get Shapes() Shape[] لیست اشیاء Shape را در صفحه برمی گرداند.
get Sheets Charts() Sheets Chart[] فهرست اشیاء Sheets Chart را در صفحه برمی‌گرداند.
get Tables() Table[] لیستی از اشیاء Table را در صفحه برمی گرداند.
get Videos() Video[] لیست اشیاء Video را در صفحه برمی گرداند.
get Word Arts() Word Art[] لیست اشیاء Word Art را در صفحه برمی گرداند.
group(pageElements) Group همه عناصر صفحه مشخص شده را گروه بندی می کند.
insert Group(group) Group یک کپی از Group ارائه شده را در صفحه درج می کند.
insert Image(blobSource) Image تصویری را در گوشه سمت چپ بالای صفحه با اندازه پیش‌فرض از حباب تصویر مشخص شده درج می‌کند.
insert Image(blobSource, left, top, width, height) Image تصویری را با موقعیت و اندازه ارائه شده از حباب تصویر مشخص شده در صفحه درج می کند.
insert Image(image) Image یک کپی از Image ارائه شده را در صفحه درج می کند.
insert Image(imageUrl) Image تصویری را در گوشه سمت چپ بالای صفحه با اندازه پیش فرض از URL ارائه شده درج می کند.
insert Image(imageUrl, left, top, width, height) Image تصویری را با موقعیت و اندازه ارائه شده از URL ارائه شده در صفحه درج می کند.
insert Line(line) Line یک کپی از Line ارائه شده را در صفحه درج می کند.
insert Line(lineCategory, startConnectionSite, endConnectionSite) Line یک خط را در صفحه ای که دو connection sites به هم متصل می کند درج می کند.
insert Line(lineCategory, startLeft, startTop, endLeft, endTop) Line یک خط در صفحه درج می کند.
insert Page Element(pageElement) Page Element یک کپی از Page Element ارائه شده را در صفحه درج می کند.
insert Shape(shape) Shape یک کپی از Shape ارائه شده را در صفحه درج می کند.
insert Shape(shapeType) Shape شکلی را در صفحه درج می کند.
insert Shape(shapeType, left, top, width, height) Shape شکلی را در صفحه درج می کند.
insert Sheets Chart(sourceChart) Sheets Chart نمودار Google Sheets را در صفحه درج می کند.
insert Sheets Chart(sourceChart, left, top, width, height) Sheets Chart نمودار Google Sheets را با موقعیت و اندازه ارائه شده در صفحه درج می کند.
insert Sheets Chart(sheetsChart) Sheets Chart یک کپی از Sheets Chart ارائه شده را در صفحه درج می کند.
insert Sheets Chart As Image(sourceChart) Image نمودار Google Sheets را به عنوان Image در صفحه درج می کند.
insert Sheets Chart As Image(sourceChart, left, top, width, height) Image نمودار کاربرگ‌نگار Google را به‌عنوان Image با موقعیت و اندازه ارائه‌شده در صفحه درج می‌کند.
insert Table(numRows, numColumns) Table جدولی را در صفحه درج می کند.
insert Table(numRows, numColumns, left, top, width, height) Table جدولی را با موقعیت و اندازه ارائه شده در صفحه درج می کند.
insert Table(table) Table یک کپی از Table ارائه شده را در صفحه درج می کند.
insert Text Box(text) Shape یک Shape جعبه متنی حاوی رشته ارائه شده را در صفحه درج می کند.
insert Text Box(text, left, top, width, height) Shape یک Shape جعبه متنی حاوی رشته ارائه شده را در صفحه درج می کند.
insert Video(videoUrl) Video یک ویدیو را در گوشه سمت چپ بالای صفحه با اندازه پیش فرض درج می کند.
insert Video(videoUrl, left, top, width, height) Video ویدئویی را با موقعیت و اندازه ارائه شده در صفحه درج می کند.
insert Video(video) Video یک کپی از Video ارائه شده را در صفحه درج می کند.
insert Word Art(wordArt) Word Art یک کپی از Word Art ارائه شده را در صفحه درج می کند.
remove() void صفحه را حذف می کند.
replace All Text(findText, replaceText) Integer همه نمونه‌های متنی که متن یافتن را با متن جایگزین مطابقت دارد جایگزین می‌کند.
replace All Text(findText, replaceText, matchCase) Integer همه نمونه‌های متنی که متن یافتن را با متن جایگزین مطابقت دارد جایگزین می‌کند.
select As Current Page() void Page در ارائه فعال را به عنوان current page selection انتخاب می کند و هر انتخاب قبلی را حذف می کند.

مستندات دقیق

as Layout()

صفحه را به صورت طرح بندی برمی گرداند.

بازگشت

Layout - صفحه به عنوان یک طرح.

مجوز

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

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

as Master()

صفحه را به عنوان اصلی برمی گرداند.

بازگشت

Master - صفحه به عنوان استاد.

مجوز

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

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

as Slide()

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

بازگشت

Slide - صفحه به صورت اسلاید.

مجوز

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

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

get Background()

پس زمینه صفحه را دریافت می کند.

بازگشت

Page Background - پس زمینه صفحه.

مجوز

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

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

get Color Scheme()

Color Scheme مرتبط با صفحه را دریافت می کند.

بازگشت

Color Scheme - طرح رنگ صفحه.

مجوز

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

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

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

مجوز

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

  • 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 Page Type()

نوع صفحه را دریافت می کند.

بازگشت

Page Type - نوع صفحه.

مجوز

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

  • 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

مجوز

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

  • 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

مجوز

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

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

get Placeholders()

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

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

group(pageElements)

تمام عناصر صفحه مشخص شده را گروه بندی می کند.

باید حداقل دو عنصر صفحه در همان صفحه وجود داشته باشد که قبلاً در گروه دیگری نیستند. برخی از عناصر صفحه، مانند Videos ، Tables و placeholder Shapes نمی‌توان گروه‌بندی کرد.

پارامترها

نام تایپ کنید توضیحات
page Elements Page Element[] عناصر برای گروه بندی با هم

بازگشت

Group - گروه جدید.

مجوز

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

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

insert Group(group)

یک کپی از Group ارائه شده را در صفحه درج می کند.

موقعیت عنصر درج شده در این صفحه از موقعیت عنصر منبع در صفحه مربوطه آن تعیین می شود.

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

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

// Copy a group between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const group = otherPresentationSlide.getGroups()[0];
currentPresentationSlide.insertGroup(
    group);  // Also available for Layout, Master, and Page.

پارامترها

نام تایپ کنید توضیحات
group Group گروهی که باید کپی و درج شود.

بازگشت

Group - گروه درج شده.

مجوز

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

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

insert Image(blobSource)

تصویری را در گوشه سمت چپ بالای صفحه با اندازه پیش‌فرض از حباب تصویر مشخص شده درج می‌کند.

با قرار دادن تصویر یک بار آن را از Blob Source دریافت می کند و یک کپی برای نمایش در داخل ارائه ذخیره می شود. اندازه تصاویر باید کمتر از 50 مگابایت باشد، نباید از 25 مگاپیکسل تجاوز کند و باید در قالب‌های PNG، JPEG یا GIF باشند. 

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
const image = DriveApp.getFileById('123abc');
slide.insertImage(image);

پارامترها

نام تایپ کنید توضیحات
blob Source Blob Source داده های تصویر

بازگشت

Image - تصویر درج شده.

مجوز

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

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

insert Image(blobSource, left, top, width, height)

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

تصویر یک بار در زمان درج از Blob Source ارائه شده واکشی می شود و یک کپی برای نمایش در داخل ارائه ذخیره می شود. اندازه تصاویر باید کمتر از 50 مگابایت باشد، نباید از 25 مگاپیکسل تجاوز کند و باید در قالب‌های PNG، JPEG یا GIF باشند.

به منظور حفظ نسبت ابعاد تصویر، تصویر با توجه به اندازه ارائه شده، مقیاس و مرکز می شود. 

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
const image = DriveApp.getFileById('123abc');
const position = {
  left: 0,
  top: 0
};
const size = {
  width: 300,
  height: 100
};
slide.insertImage(image, position.left, position.top, size.width, size.height);

پارامترها

نام تایپ کنید توضیحات
blob Source Blob Source داده های تصویر
left Number موقعیت افقی تصویر در نقاط، از گوشه سمت چپ بالای صفحه اندازه گیری می شود.
top Number موقعیت عمودی تصویر در نقاط، از گوشه سمت چپ بالای صفحه اندازه گیری می شود.
width Number عرض تصویر بر حسب نقاط.
height Number ارتفاع تصویر بر حسب نقاط.

بازگشت

Image - تصویر درج شده.

مجوز

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

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

insert Image(image)

یک کپی از Image ارائه شده را در صفحه درج می کند.

موقعیت تصاویر درج شده در این صفحه از موقعیت تصویر منبع در صفحه مربوطه تعیین می شود.

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

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

// Copy an image between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const image = otherPresentationSlide.getImages[0];
currentPresentationSlide.insertImage(image);

پارامترها

نام تایپ کنید توضیحات
image Image تصویری که باید کپی و درج شود.

بازگشت

Image - تصویر درج شده.

مجوز

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

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

insert Image(imageUrl)

تصویری را در گوشه سمت چپ بالای صفحه با اندازه پیش فرض از URL ارائه شده درج می کند.

درج تصویر یک بار آن را از URL واکشی می کند و یک کپی برای نمایش در داخل ارائه ذخیره می شود. اندازه تصاویر باید کمتر از 50 مگابایت باشد، نباید از 25 مگاپیکسل تجاوز کند و باید در قالب‌های PNG، JPEG یا GIF باشند.

URL ارائه شده باید برای عموم قابل دسترسی باشد و بزرگتر از 2 کیلوبایت نباشد. خود URL با تصویر ذخیره می شود و از طریق Image.getSourceUrl() در معرض دید قرار می گیرد.

پارامترها

نام تایپ کنید توضیحات
image Url String آدرس تصویر.

بازگشت

Image - تصویر درج شده.

مجوز

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

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

insert Image(imageUrl, left, top, width, height)

تصویری را با موقعیت و اندازه ارائه شده از URL ارائه شده در صفحه درج می کند.

درج تصویر یک بار آن را از URL واکشی می کند و یک کپی برای نمایش در داخل ارائه ذخیره می شود. اندازه تصاویر باید کمتر از 50 مگابایت باشد، نباید از 25 مگاپیکسل تجاوز کند و باید در قالب‌های PNG، JPEG یا GIF باشند.

URL ارائه شده باید برای عموم قابل دسترسی باشد و بزرگتر از 2 کیلوبایت نباشد. خود URL با تصویر ذخیره می شود و از طریق Image.getSourceUrl() در معرض دید قرار می گیرد.

به منظور حفظ نسبت ابعاد تصویر، تصویر با توجه به اندازه ارائه شده، مقیاس و مرکز می شود.

پارامترها

نام تایپ کنید توضیحات
image Url String آدرس تصویر.
left Number موقعیت افقی تصویر در نقاط، از گوشه سمت چپ بالای صفحه اندازه گیری می شود.
top Number موقعیت عمودی تصویر در نقاط، از گوشه سمت چپ بالای صفحه اندازه گیری می شود.
width Number عرض تصویر بر حسب نقاط.
height Number ارتفاع تصویر بر حسب نقطه

بازگشت

Image - تصویر درج شده.

مجوز

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

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

insert Line(line)

یک کپی از Line ارائه شده را در صفحه درج می کند.

موقعیت عنصر درج شده در این صفحه از موقعیت عنصر منبع در صفحه مربوطه آن تعیین می شود.

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

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

// Copy a line between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const line = otherPresentationSlide.getLines[0];
currentPresentationSlide.insertLine(line);

پارامترها

نام تایپ کنید توضیحات
line Line خطی که باید کپی و درج شود.

بازگشت

Line - خط درج شده.

مجوز

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

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

insert Line(lineCategory, startConnectionSite, endConnectionSite)

یک خط را در صفحه ای که دو connection sites به هم متصل می کند درج می کند. دو سایت اتصال باید در این صفحه باشند. 

// Insert a line in the first slide of the presentation connecting two shapes.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const shape1 = slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
const shape2 = slide.insertShape(SlidesApp.ShapeType.CLOUD);
slide.insertLine(
    SlidesApp.LineCategory.BENT,
    shape1.getConnectionSites()[0],
    shape2.getConnectionSites()[1],
);

پارامترها

نام تایپ کنید توضیحات
line Category Line Category دسته خط برای درج.
start Connection Site Connection Site محل اتصال که قرار است شروع خط وصل شود.
end Connection Site Connection Site محل اتصال که قرار است انتهای خط وصل شود.

بازگشت

Line - خط درج شده.

مجوز

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

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

insert Line(lineCategory, startLeft, startTop, endLeft, endTop)

یک خط در صفحه درج می کند. 

// Insert a line in the first slide of the presentation.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const startPoint = {
  left: 10,
  top: 10
};
const endPoint = {
  left: 40,
  top: 40
};
slide.insertLine(
    SlidesApp.LineCategory.STRAIGHT,
    startPoint.left,
    startPoint.top,
    endPoint.left,
    endPoint.top,
);

پارامترها

نام تایپ کنید توضیحات
line Category Line Category دسته خط برای درج.
start Left Number موقعیت افقی نقطه شروع خط، در نقاط از گوشه سمت چپ بالای صفحه اندازه گیری می شود.
start Top Number موقعیت عمودی نقطه شروع خط، در نقاطی از گوشه سمت چپ بالای صفحه اندازه گیری می شود.
end Left Number موقعیت افقی نقطه پایانی خط، در نقاط از گوشه سمت چپ بالای صفحه اندازه گیری می شود.
end Top Number موقعیت عمودی نقطه پایانی خط، بر حسب نقاط از گوشه سمت چپ بالای صفحه اندازه گیری می شود.

بازگشت

Line - خط درج شده.

مجوز

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

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

insert Page Element(pageElement)

یک کپی از Page Element ارائه شده را در صفحه درج می کند.

موقعیت عنصر درج شده در این صفحه از موقعیت عنصر منبع در صفحه مربوطه آن تعیین می شود.

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

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

// Copy a page element between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const pageElement = otherPresentationSlide.getPageElements()[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertPageElement(pageElement);

پارامترها

نام تایپ کنید توضیحات
page Element Page Element عنصر صفحه که باید کپی و درج شود.

بازگشت

Page Element - عنصر صفحه درج شده.

مجوز

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

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

insert Shape(shape)

یک کپی از Shape ارائه شده را در صفحه درج می کند.

موقعیت عنصر درج شده در این صفحه از موقعیت عنصر منبع در صفحه مربوطه آن تعیین می شود.

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

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

// Copy a shape between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const shape = otherPresentationSlide.getShapes[0];
currentPresentationSlide.insertShape(
    shape);  // Also available for Layout, Master, and Page.

پارامترها

نام تایپ کنید توضیحات
shape Shape شکلی که باید کپی و درج شود.

بازگشت

Shape - شکل درج شده.

مجوز

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

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

insert Shape(shapeType)

شکلی را در صفحه درج می کند.

شکل با اندازه پیش فرض در گوشه سمت چپ بالای صفحه درج می شود. 

// Insert a shape in the first slide of the presentation.
const slide = SlidesApp.getActivePresentation().getSlides()[0];

// Also available for Layout, Master, and Page.
slide.insertShape(SlidesApp.ShapeType.RECTANGLE);

پارامترها

نام تایپ کنید توضیحات
shape Type Shape Type نوع شکل برای درج.

بازگشت

Shape - شکل درج شده.

مجوز

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

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

insert Shape(shapeType, left, top, width, height)

شکلی را در صفحه درج می کند.

پارامترها

نام تایپ کنید توضیحات
shape Type Shape Type نوع شکل برای درج.
left Number موقعیت افقی شکل، از گوشه سمت چپ بالای صفحه اندازه گیری می شود.
top Number موقعیت عمودی شکل، از گوشه سمت چپ بالای صفحه اندازه گیری می شود.
width Number عرض شکل.
height Number ارتفاع شکل.

بازگشت

Shape - شکل درج شده.

مجوز

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

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

insert Sheets Chart(sourceChart)

نمودار Google Sheets را در صفحه درج می کند.

نمودار با اندازه پیش فرض در گوشه سمت چپ بالای صفحه درج می شود.

نمودار درج شده با نمودار منبع Google Sheets مرتبط است که به آن امکان به روز رسانی را می دهد. سایر همکاران می توانند پیوند صفحه گسترده منبع را ببینند. 

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertSheetsChart(chart);

پارامترها

نام تایپ کنید توضیحات
source Chart Embedded Chart نمودار در یک صفحه گسترده برای درج در صفحه.

بازگشت

Sheets Chart - نمودار درج شده در صفحه.

مجوز

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

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

insert Sheets Chart(sourceChart, left, top, width, height)

نمودار Google Sheets را با موقعیت و اندازه ارائه شده در صفحه درج می کند.

به منظور حفظ نسبت ابعاد نمودار، نمودار با توجه به اندازه ارائه شده، مقیاس و مرکز می شود.

نمودار درج شده با نمودار منبع Google Sheets مرتبط است که به آن امکان به روز رسانی را می دهد. سایر همکاران می توانند پیوند صفحه گسترده منبع را ببینند. 

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const position = {
  left: 0,
  top: 0
};
const size = {
  width: 200,
  height: 200
};

// Also available for Layout, Master, and Page.
slide.insertSheetsChart(
    chart,
    position.left,
    position.top,
    size.width,
    size.height,
);

پارامترها

نام تایپ کنید توضیحات
source Chart Embedded Chart نمودار در یک صفحه گسترده برای درج در صفحه.
left Number موقعیت افقی نمودار در نقاط، از گوشه سمت چپ بالای صفحه اندازه گیری می شود.
top Number موقعیت عمودی نمودار در نقاط، از گوشه سمت چپ بالای صفحه اندازه گیری می شود.
width Number عرض نمودار در نقاط.
height Number ارتفاع نمودار بر حسب نقطه

بازگشت

Sheets Chart - نمودار درج شده در صفحه.

مجوز

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

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

insert Sheets Chart(sheetsChart)

یک کپی از Sheets Chart ارائه شده را در صفحه درج می کند.

موقعیت عنصر درج شده در این صفحه از موقعیت عنصر منبع در صفحه مربوطه آن تعیین می شود.

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

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

// Copy a sheets chart between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const sheetsChart = otherPresentationSlide.getSheetsCharts[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertSheetsChart(sheetsChart);

پارامترها

نام تایپ کنید توضیحات
sheets Chart Sheets Chart نمودار شیت ها کپی و درج می شود.

بازگشت

Sheets Chart - نمودار ورق درج شده.

مجوز

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

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

insert Sheets Chart As Image(sourceChart)

نمودار Google Sheets را به عنوان Image در صفحه درج می کند.

تصویر نمودار با اندازه پیش فرض در گوشه سمت چپ بالای صفحه درج شده است.

تصویر درج شده نمودار با نمودار منبع Google Sheets مرتبط نیست. 

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertSheetsChartAsImage(
    chart);  // Also available for Layout, Master, and Page.

پارامترها

نام تایپ کنید توضیحات
source Chart Embedded Chart نمودار در یک صفحه گسترده برای درج در صفحه.

بازگشت

Image - تصویر درج شده از نمودار در صفحه.

مجوز

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

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

insert Sheets Chart As Image(sourceChart, left, top, width, height)

نمودار کاربرگ‌نگار Google را به‌عنوان Image با موقعیت و اندازه ارائه‌شده در صفحه درج می‌کند.

به منظور حفظ نسبت تصویر نمودار، تصویر با توجه به اندازه ارائه شده، مقیاس و مرکز می شود.

تصویر درج شده نمودار با نمودار منبع Google Sheets مرتبط نیست. 

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const position = {
  left: 0,
  top: 0
};
const size = {
  width: 200,
  height: 200
};

// Also available for Layout, Master, and Page.
slide.insertSheetsChartAsImage(
    chart,
    position.left,
    position.right,
    size.width,
    size.height,
);

پارامترها

نام تایپ کنید توضیحات
source Chart Embedded Chart نمودار در یک صفحه گسترده برای درج در صفحه.
left Number موقعیت افقی نمودار در نقاط، از گوشه سمت چپ بالای صفحه اندازه گیری می شود.
top Number موقعیت عمودی نمودار در نقاط، از گوشه سمت چپ بالای صفحه اندازه گیری می شود.
width Number عرض نمودار در نقاط.
height Number ارتفاع نمودار بر حسب نقطه

بازگشت

Image - تصویر درج شده از نمودار در صفحه.

مجوز

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

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

insert Table(numRows, numColumns)

جدولی را در صفحه درج می کند.

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

پارامترها

نام تایپ کنید توضیحات
num Rows Integer تعداد ردیف های جدول
num Columns Integer تعداد ستون های جدول

بازگشت

Table - جدول درج شده.

مجوز

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

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

insert Table(numRows, numColumns, left, top, width, height)

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

سطرها و ستون ها به طور مساوی در جدول ایجاد شده توزیع شده اند.

پارامترها

نام تایپ کنید توضیحات
num Rows Integer تعداد ردیف های جدول
num Columns Integer تعداد ستون های جدول
left Number موقعیت افقی جدول، از گوشه سمت چپ بالای صفحه اندازه گیری می شود.
top Number موقعیت عمودی جدول، از گوشه سمت چپ بالای صفحه اندازه گیری می شود.
width Number عرض میز.
height Number حداقل ارتفاع میز. ارتفاع واقعی جدول رندر شده به عواملی مانند اندازه فونت متن بستگی دارد.

بازگشت

Table - جدول درج شده.

مجوز

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

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

insert Table(table)

یک کپی از Table ارائه شده را در صفحه درج می کند.

موقعیت عنصر درج شده در این صفحه از موقعیت عنصر منبع در صفحه مربوطه آن تعیین می شود.

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

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

// Copy a table between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const table = otherPresentationSlide.getTables[0];
currentPresentationSlide.insertTable(
    table);  // Also available for Layout, Master, and Page.

پارامترها

نام تایپ کنید توضیحات
table Table جدولی که باید کپی و درج شود.

بازگشت

Table - جدول درج شده.

مجوز

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

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

insert Text Box(text)

یک Shape جعبه متنی حاوی رشته ارائه شده را در صفحه درج می کند.

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

// Insert text box with "Hello" on the first slide of presentation.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertTextBox('Hello');  // Also available for Layout, Master, and Page.

پارامترها

نام تایپ کنید توضیحات
text String رشته ای که شکل جعبه متن باید حاوی باشد.

بازگشت

Shape - شکل جعبه متن درج شده.

مجوز

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

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

insert Text Box(text, left, top, width, height)

یک Shape جعبه متنی حاوی رشته ارائه شده را در صفحه درج می کند. 

// Insert text box with "Hello" on the first slide of presentation. This text
// box is a square with a length of 10 points on each side.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertTextBox(
    'Hello', 0, 0, 10, 10);  // Also available for Layout, Master, and Page.

پارامترها

نام تایپ کنید توضیحات
text String رشته ای که شکل جعبه متن باید حاوی باشد.
left Number موقعیت افقی شکل جعبه متن، از گوشه سمت چپ بالای صفحه اندازه گیری می شود.
top Number موقعیت عمودی شکل جعبه متن، از گوشه سمت چپ بالای صفحه اندازه گیری می شود.
width Number عرض شکل جعبه متن.
height Number ارتفاع شکل جعبه متن.

بازگشت

Shape - شکل جعبه متن درج شده.

مجوز

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

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

insert Video(videoUrl)

یک ویدیو را در گوشه سمت چپ بالای صفحه با اندازه پیش فرض درج می کند.

در حال حاضر فقط ویدیوهای YouTube پشتیبانی می شوند.

پارامترها

نام تایپ کنید توضیحات
video Url String آدرس ویدیو برای درج.

بازگشت

Video - ویدئوی درج شده.

مجوز

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

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

insert Video(videoUrl, left, top, width, height)

ویدئویی را با موقعیت و اندازه ارائه شده در صفحه درج می کند.

در حال حاضر فقط ویدیوهای YouTube پشتیبانی می شوند.

پارامترها

نام تایپ کنید توضیحات
video Url String آدرس ویدیو برای درج.
left Number موقعیت افقی ویدیو در نقاط، از گوشه سمت چپ بالای صفحه اندازه گیری می شود.
top Number موقعیت عمودی ویدیو در نقاط، از گوشه سمت چپ بالای صفحه اندازه‌گیری می‌شود.
width Number عرض ویدیو به نقاط.
height Number ارتفاع ویدیو بر حسب امتیاز

بازگشت

Video - ویدئوی درج شده.

مجوز

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

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

insert Video(video)

یک کپی از Video ارائه شده را در صفحه درج می کند.

موقعیت عنصر درج شده در این صفحه از موقعیت عنصر منبع در صفحه مربوطه آن تعیین می شود.

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

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

// Copy a video between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const video = otherPresentationSlide.getVideos[0];
currentPresentationSlide.insertVideo(
    video);  // Also available for Layout, Master, and Page.

پارامترها

نام تایپ کنید توضیحات
video Video ویدیو کپی و درج شود.

بازگشت

Video - ویدئوی درج شده.

مجوز

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

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

insert Word Art(wordArt)

یک کپی از Word Art ارائه شده را در صفحه درج می کند.

موقعیت عنصر درج شده در این صفحه از موقعیت عنصر منبع در صفحه مربوطه آن تعیین می شود.

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

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

// Copy a word art between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const wordArt = otherPresentationSlide.getWordArts[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertWordArt(wordArt);

پارامترها

نام تایپ کنید توضیحات
word Art Word Art گروهی که باید کپی و درج شود.

بازگشت

Word Art - هنر کلمه درج شده.

مجوز

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

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

remove()

صفحه را حذف می کند.

مجوز

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

  • 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

select As Current Page()

Page در ارائه فعال را به عنوان current page selection انتخاب می کند و هر انتخاب قبلی را حذف می کند.

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

// Select the first slide as the current page selection and replace any previous
// selection.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.selectAsCurrentPage();  // Also available for Layout, Master, and Page.

مجوز

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

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