Class Master

استاد

استاد در ارائه.

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

  • شکل‌های جای‌نگهدار روی یک شکل اصلی، شامل سبک‌های متن پیش‌فرض و ویژگی‌های شکل تمام شکل‌های جای‌نگهدار در صفحاتی هستند که از آن شکل اصلی استفاده می‌کنند.
  • ویژگی‌های یک صفحه اصلی، ویژگی‌های مشترک صفحه را که توسط طرح‌بندی‌های آن به ارث برده می‌شوند، تعریف می‌کنند.
  • هر شکل دیگری که در اسلاید اصلی باشد، صرف نظر از طرح‌بندی آنها، در تمام اسلایدهایی که از آن اسلاید اصلی استفاده می‌کنند، ظاهر می‌شود.

روش‌ها

روش نوع بازگشتی شرح مختصر
get Background() Page Background پس‌زمینه صفحه را دریافت می‌کند.
get Color Scheme() Color Scheme Color Scheme مرتبط با صفحه را دریافت می‌کند.
get Groups() Group[] لیست اشیاء Group را در صفحه برمی‌گرداند.
get Images() Image[] لیست اشیاء Image موجود در صفحه را برمی‌گرداند.
get Layouts() Layout[] طرح‌بندی‌های این استاد را دریافت می‌کند.
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 Page Type() Page Type نوع صفحه را دریافت می‌کند.
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 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 Sheets را به عنوان 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 تمام نمونه‌های متن منطبق با find text را با replace text جایگزین می‌کند.
replace All Text(findText, replaceText, matchCase) Integer تمام نمونه‌های متن منطبق با find text را با replace text جایگزین می‌کند.
select As Current Page() void Page در ارائه فعال را به عنوان current page selection انتخاب می‌کند و هر انتخاب قبلی را حذف می‌کند.

مستندات دقیق

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 Layouts()

طرح‌بندی‌های این استاد را دریافت می‌کند.

بازگشت

Layout[]

مجوز

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

  • 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 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 |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 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 ارائه شده را در صفحه قرار می‌دهد.

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

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

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

// 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 دریافت می‌کند و یک کپی از آن برای نمایش در داخل ارائه ذخیره می‌شود. حجم تصاویر باید کمتر از ۵۰ مگابایت باشد، نمی‌تواند از ۲۵ مگاپیکسل بیشتر باشد و باید در قالب 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 ارائه شده دریافت می‌شود و یک کپی برای نمایش در داخل ارائه ذخیره می‌شود. حجم تصاویر باید کمتر از ۵۰ مگابایت باشد، نمی‌تواند از ۲۵ مگاپیکسل بیشتر باشد و باید در قالب 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 ارائه شده را در صفحه قرار می‌دهد.

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

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

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

// 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 دریافت می‌کند و یک کپی برای نمایش در داخل ارائه ذخیره می‌شود. حجم تصاویر باید کمتر از ۵۰ مگابایت باشد، نمی‌تواند از ۲۵ مگاپیکسل بیشتر باشد و باید در قالب PNG، JPEG یا GIF باشد.

URL ارائه شده باید به صورت عمومی قابل دسترسی باشد و حجم آن از ۲ کیلوبایت بیشتر نباشد. خود 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 دریافت می‌کند و یک کپی برای نمایش در داخل ارائه ذخیره می‌شود. حجم تصاویر باید کمتر از ۵۰ مگابایت باشد، نمی‌تواند از ۲۵ مگاپیکسل بیشتر باشد و باید در قالب PNG، JPEG یا GIF باشد.

URL ارائه شده باید به صورت عمومی قابل دسترسی باشد و حجم آن از ۲ کیلوبایت بیشتر نباشد. خود 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 ارائه شده را در صفحه درج می‌کند.

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

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

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

// 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 ارائه شده را در صفحه درج می‌کند.

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

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

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

// 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 ارائه شده را در صفحه درج می‌کند.

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

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

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

// 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 در صفحه درج می‌کند.

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

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

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 با موقعیت و اندازه ارائه شده در صفحه درج می‌کند.

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

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

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 ارائه شده را در صفحه درج می‌کند.

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

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

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

// 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 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];
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 ارائه شده را در صفحه درج می‌کند.

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

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

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

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

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

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

پارامترها

نام نوع توضیحات
video Url String آدرس اینترنتی (URL) ویدیویی که قرار است درج شود.

بازگشت

Video — ویدیوی درج شده.

مجوز

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

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

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

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

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

پارامترها

نام نوع توضیحات
video Url String آدرس اینترنتی (URL) ویدیویی که قرار است درج شود.
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 ارائه شده را در صفحه قرار می‌دهد.

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

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

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

// 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 ارائه شده را در صفحه قرار می‌دهد.

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

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

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

// 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 را با متن جایگزین جایگزین می‌کند. جستجو به حروف کوچک و بزرگ حساس نیست.

پارامترها

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

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