Class Slide

اسلاید

اسلاید در ارائه.

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

روش ها

روش نوع برگشت شرح مختصر
duplicate() Slide اسلاید را کپی می کند.
getBackground() PageBackground پس زمینه صفحه را دریافت می کند.
getColorScheme() ColorScheme ColorScheme مرتبط با صفحه را دریافت می کند.
getGroups() Group[] فهرست اشیاء Group را در صفحه برمی گرداند.
getImages() Image[] لیست اشیاء Image را در صفحه برمی گرداند.
getLayout() Layout طرحی که اسلاید بر اساس آن است را دریافت می کند یا اگر اسلاید بر اساس طرح بندی نباشد، null می شود.
getLines() Line[] لیست اشیاء Line را در صفحه برمی گرداند.
getNotesPage() NotesPage صفحه یادداشت های مرتبط با اسلاید را برمی گرداند.
getObjectId() String شناسه منحصر به فرد صفحه را دریافت می کند.
getPageElementById(id) PageElement PageElement در صفحه با شناسه داده شده برمی گرداند، یا اگر هیچ کدام وجود نداشته باشد null کند.
getPageElements() PageElement[] لیستی از اشیاء PageElement ارائه شده در صفحه را برمی گرداند.
getPageType() PageType نوع صفحه را دریافت می کند.
getPlaceholder(placeholderType) PageElement شیء PageElement مکان نگهدار را برای PlaceholderType مشخص شده برمی‌گرداند یا اگر مکان‌نمای منطبقی وجود نداشته باشد null برمی‌گرداند.
getPlaceholder(placeholderType, placeholderIndex) PageElement شیء PageElement مکان نگهدار را برای یک PlaceholderType مشخص شده و یک نمایه نگهدارنده مکان برمی گرداند، یا اگر جای جای وجود نداشته باشد، null .
getPlaceholders() PageElement[] فهرست اشیاء PageElement نگهدارنده مکان را در صفحه برمی‌گرداند.
getShapes() Shape[] لیست اشیاء Shape را در صفحه برمی گرداند.
getSheetsCharts() SheetsChart[] فهرست اشیاء SheetsChart را در صفحه برمی‌گرداند.
getSlideLinkingMode() SlideLinkingMode یک SlideLinkingMode برمی‌گرداند که نشان می‌دهد آیا اسلاید به اسلاید دیگری مرتبط است یا خیر.
getSourcePresentationId() String در صورتی که اسلاید پیوند داده نشده باشد، شناسه Presentation منبع را null .
getSourceSlideObjectId() String شناسه اسلاید منبع را برمی‌گرداند یا اگر اسلاید پیوند داده نشده باشد، null برمی‌گرداند.
getTables() Table[] لیستی از اشیاء Table را در صفحه برمی گرداند.
getVideos() Video[] لیست اشیاء Video را در صفحه برمی گرداند.
getWordArts() WordArt[] لیستی از اشیاء WordArt را در صفحه برمی گرداند.
group(pageElements) Group همه عناصر صفحه مشخص شده را گروه بندی می کند.
insertGroup(group) Group یک کپی از Group ارائه شده را در صفحه درج می کند.
insertImage(blobSource) Image تصویری را در گوشه سمت چپ بالای صفحه با اندازه پیش‌فرض از حباب تصویر مشخص شده درج می‌کند.
insertImage(blobSource, left, top, width, height) Image تصویری را با موقعیت و اندازه ارائه شده از حباب تصویر مشخص شده در صفحه درج می کند.
insertImage(image) Image یک کپی از Image ارائه شده را در صفحه درج می کند.
insertImage(imageUrl) Image تصویری را در گوشه سمت چپ بالای صفحه با اندازه پیش فرض از URL ارائه شده درج می کند.
insertImage(imageUrl, left, top, width, height) Image تصویری را با موقعیت و اندازه ارائه شده از URL ارائه شده در صفحه درج می کند.
insertLine(line) Line یک کپی از Line ارائه شده را در صفحه درج می کند.
insertLine(lineCategory, startConnectionSite, endConnectionSite) Line یک خط را در صفحه ای که دو connection sites به هم متصل می کند درج می کند.
insertLine(lineCategory, startLeft, startTop, endLeft, endTop) Line یک خط در صفحه درج می کند.
insertPageElement(pageElement) PageElement یک کپی از PageElement ارائه شده را در صفحه درج می کند.
insertShape(shape) Shape یک کپی از Shape ارائه شده را در صفحه درج می کند.
insertShape(shapeType) Shape شکلی را در صفحه درج می کند.
insertShape(shapeType, left, top, width, height) Shape شکلی را در صفحه درج می کند.
insertSheetsChart(sourceChart) SheetsChart نمودار Google Sheets را در صفحه درج می کند.
insertSheetsChart(sourceChart, left, top, width, height) SheetsChart نمودار Google Sheets را با موقعیت و اندازه ارائه شده در صفحه درج می کند.
insertSheetsChart(sheetsChart) SheetsChart یک کپی از SheetsChart ارائه شده را در صفحه درج می کند.
insertSheetsChartAsImage(sourceChart) Image نمودار Google Sheets را به عنوان Image در صفحه درج می کند.
insertSheetsChartAsImage(sourceChart, left, top, width, height) Image نمودار کاربرگ‌نگار Google را به‌عنوان Image با موقعیت و اندازه ارائه‌شده در صفحه درج می‌کند.
insertTable(numRows, numColumns) Table جدولی را در صفحه درج می کند.
insertTable(numRows, numColumns, left, top, width, height) Table جدولی را با موقعیت و اندازه ارائه شده در صفحه درج می کند.
insertTable(table) Table یک کپی از Table ارائه شده را در صفحه درج می کند.
insertTextBox(text) Shape یک Shape جعبه متنی حاوی رشته ارائه شده را در صفحه درج می کند.
insertTextBox(text, left, top, width, height) Shape یک Shape جعبه متنی حاوی رشته ارائه شده را در صفحه درج می کند.
insertVideo(videoUrl) Video یک ویدیو را در گوشه سمت چپ بالای صفحه با اندازه پیش فرض درج می کند.
insertVideo(videoUrl, left, top, width, height) Video ویدئویی را با موقعیت و اندازه ارائه شده در صفحه درج می کند.
insertVideo(video) Video یک کپی از Video ارائه شده را در صفحه درج می کند.
insertWordArt(wordArt) WordArt یک کپی از WordArt ارائه شده را در صفحه درج می کند.
isSkipped() Boolean نشان می دهد که آیا اسلاید در حالت ارائه رد شده است یا خیر.
move(index) void اسلاید را به نمایه مشخص شده منتقل کنید.
refreshSlide() void اسلاید را تازه می کند تا هرگونه تغییر ایجاد شده در اسلاید منبع پیوند شده را منعکس کند.
remove() void صفحه را حذف می کند.
replaceAllText(findText, replaceText) Integer همه نمونه‌های متنی که متن یافتن را با متن جایگزین مطابقت دارد جایگزین می‌کند.
replaceAllText(findText, replaceText, matchCase) Integer همه نمونه‌های متنی که متن یافتن را با متن جایگزین مطابقت دارد جایگزین می‌کند.
selectAsCurrentPage() void Page در ارائه فعال را به عنوان current page selection انتخاب می کند و هر انتخاب قبلی را حذف می کند.
setSkipped(isSkipped) void تنظیم می کند که آیا اسلاید در حالت ارائه رد شود یا خیر.
unlink() void Slide فعلی را از اسلاید منبع آن جدا می کند.

مستندات دقیق

duplicate()

اسلاید را کپی می کند.

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

بازگشت

Slide - اسلاید تکراری.

مجوز

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

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

getBackground()

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

بازگشت

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

مجوز

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

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

getColorScheme()

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

بازگشت

ColorScheme - طرح رنگی صفحه.

مجوز

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

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

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

getLayout()

طرحی که اسلاید بر اساس آن است را دریافت می کند یا اگر اسلاید بر اساس طرح بندی نباشد، null می شود.

بازگشت

Layout

مجوز

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

  • 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

getNotesPage()

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

بازگشت

NotesPage

مجوز

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

  • 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 در صفحه با شناسه داده شده برمی گرداند، یا اگر هیچ کدام وجود نداشته باشد null کند.

پارامترها

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

بازگشت

PageElement - عنصر صفحه با شناسه داده شده.

مجوز

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

  • 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

getPageType()

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

بازگشت

PageType - نوع صفحه.

مجوز

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

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

getPlaceholder(placeholderType)

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

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

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

پارامترها

نام تایپ کنید توضیحات
placeholderType PlaceholderType

بازگشت

PageElement

مجوز

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

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

getPlaceholder(placeholderType, placeholderIndex)

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

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

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

پارامترها

نام تایپ کنید توضیحات
placeholderType PlaceholderType
placeholderIndex Integer

بازگشت

PageElement

مجوز

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

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

getPlaceholders()

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

var 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

getSlideLinkingMode()

یک SlideLinkingMode برمی‌گرداند که نشان می‌دهد آیا اسلاید به اسلاید دیگری مرتبط است یا خیر.

بازگشت

SlideLinkingMode - حالت پیوند اسلاید.

مجوز

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

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

getSourcePresentationId()

در صورتی که اسلاید پیوند داده نشده باشد، شناسه Presentation منبع را null .

یک اسلاید فقط زمانی دارای شناسه Presentation منبع است که به اسلایدی در ارائه دیگری پیوند داده شود.

بازگشت

String - شناسه ارائه منبع یا null .

مجوز

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

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

getSourceSlideObjectId()

شناسه اسلاید منبع را برمی‌گرداند یا اگر اسلاید پیوند داده نشده باشد، null برمی‌گرداند.

اسلاید فقط زمانی دارای شناسه اسلاید منبع است که به اسلاید موجود در ارائه دیگری پیوند داده شود.

بازگشت

String - شناسه اسلاید منبع یا null .

مجوز

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

  • 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

group(pageElements)

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

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

پارامترها

نام تایپ کنید توضیحات
pageElements PageElement[] عناصر برای گروه بندی با هم

بازگشت

Group - گروه جدید.

مجوز

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

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

insertGroup(group)

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

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

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

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

// Copy a group between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var 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

insertImage(blobSource)

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

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

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

پارامترها

نام تایپ کنید توضیحات
blobSource BlobSource داده های تصویر

بازگشت

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

مجوز

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

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

insertImage(blobSource, left, top, width, height)

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

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

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

insertImage(image)

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

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

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

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

insertImage(imageUrl)

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

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

insertImage(imageUrl, left, top, width, height)

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

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

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

insertLine(line)

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

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

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

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

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

پارامترها

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

بازگشت

Line - خط درج شده.

مجوز

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

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

insertLine(lineCategory, startConnectionSite, endConnectionSite)

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

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

پارامترها

نام تایپ کنید توضیحات
lineCategory LineCategory دسته بندی خط برای درج.
startConnectionSite ConnectionSite محل اتصال که قرار است شروع خط وصل شود.
endConnectionSite ConnectionSite محل اتصال که قرار است انتهای خط وصل شود.

بازگشت

Line - خط درج شده.

مجوز

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

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

insertLine(lineCategory, startLeft, startTop, endLeft, endTop)

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

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

پارامترها

نام تایپ کنید توضیحات
lineCategory LineCategory دسته بندی خط برای درج.
startLeft Number موقعیت افقی نقطه شروع خط، در نقاط از گوشه سمت چپ بالای صفحه اندازه گیری می شود.
startTop Number موقعیت عمودی نقطه شروع خط، در نقاطی از گوشه سمت چپ بالای صفحه اندازه گیری می شود.
endLeft Number موقعیت افقی نقطه پایانی خط، در نقاط از گوشه سمت چپ بالای صفحه اندازه گیری می شود.
endTop Number موقعیت عمودی نقطه پایانی خط، بر حسب نقاط از گوشه سمت چپ بالای صفحه اندازه گیری می شود.

بازگشت

Line - خط درج شده.

مجوز

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

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

insertPageElement(pageElement)

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

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

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

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

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

insertShape(shape)

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

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

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

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

// Copy a shape between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var 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

insertShape(shapeType)

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

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

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

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

پارامترها

نام تایپ کنید توضیحات
shapeType ShapeType نوع شکل برای درج.

بازگشت

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

مجوز

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

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

insertShape(shapeType, left, top, width, height)

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

پارامترها

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

بازگشت

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

مجوز

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

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

insertSheetsChart(sourceChart)

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

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

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

insertSheetsChart(sourceChart, left, top, width, height)

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

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

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

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

insertSheetsChart(sheetsChart)

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

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

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

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

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

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

پارامترها

نام تایپ کنید توضیحات
sheetsChart SheetsChart نمودار شیت ها کپی و درج می شود.

بازگشت

SheetsChart - نمودار صفحات درج شده.

مجوز

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

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

insertSheetsChartAsImage(sourceChart)

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

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

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

insertSheetsChartAsImage(sourceChart, left, top, width, height)

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

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

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

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

insertTable(numRows, numColumns)

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

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

پارامترها

نام تایپ کنید توضیحات
numRows Integer تعداد ردیف های جدول
numColumns Integer تعداد ستون های جدول

بازگشت

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

مجوز

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

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

insertTable(numRows, numColumns, left, top, width, height)

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

insertTable(table)

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

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

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

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

// Copy a table between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var 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

insertTextBox(text)

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

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

// Insert text box with "Hello" on the first slide of presentation.
var 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

insertTextBox(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.
var 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

insertVideo(videoUrl)

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

insertVideo(videoUrl, left, top, width, height)

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

insertVideo(video)

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

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

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

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

// Copy a video between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var 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

insertWordArt(wordArt)

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

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

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

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

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

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

پارامترها

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

بازگشت

WordArt - هنر کلمه درج شده.

مجوز

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

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

isSkipped()

نشان می دهد که آیا اسلاید در حالت ارائه رد شده است یا خیر.

بازگشت

Boolean - اگر اسلاید در حالت ارائه رد شود True .

مجوز

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

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

move(index)

اسلاید را به نمایه مشخص شده منتقل کنید.

پارامترها

نام تایپ کنید توضیحات
index Integer شاخصی که اسلاید باید به آن منتقل شود، بر اساس آرایش اسلاید قبل از حرکت. شاخص باید بین صفر و تعداد اسلایدهای ارائه شده باشد.

مجوز

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

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

refreshSlide()

اسلاید را تازه می کند تا هرگونه تغییر ایجاد شده در اسلاید منبع پیوند شده را منعکس کند. اگر این اسلاید پیوند داده نشده باشد، بدون ایجاد تغییر برمی گردد.

متد refreshSlide صفحات اصلی و صفحه‌آرایی متناظر اسلاید منبع پیوند شده را در صورتی که قبلاً وجود نداشته باشند، در ارائه اسلاید کپی می‌کند. اگر از قبل وجود داشته باشند، به همین ترتیب به روز می شوند تا تغییرات ایجاد شده در منبع را منعکس کنند.

var currentPresentation = SlidesApp.getActivePresentation();
var sourcePresentation = SlidesApp.openById('sourcePresentationId');
var sourceSlide = sourcePresentation.getSlides()[0];
var linkedSlide = currentPresentation.append(sourceSlide, SlidesApp.SlideLinkingMode.LINKED);

sourceSlide.insertText('hello world'); // Only the source slide has the text box.

linkedSlide.refreshSlide(); // The linked slide now has the text box.

پرتاب می کند

Error - اگر دسترسی خواندنی به ارائه منبع دیگر در دسترس نباشد.

مجوز

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

  • 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

replaceAllText(findText, replaceText)

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

پارامترها

نام تایپ کنید توضیحات
findText String متن برای پیدا کردن.
replaceText String متنی که جایگزین متن منطبق می شود.

بازگشت

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

مجوز

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

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

replaceAllText(findText, replaceText, matchCase)

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

پارامترها

نام تایپ کنید توضیحات
findText String متن برای پیدا کردن.
replaceText String متنی که جایگزین متن منطبق می شود.
matchCase Boolean اگر true ، جستجو به حروف کوچک و بزرگ حساس است. اگر false باشد، جستجو به حروف بزرگ و کوچک حساس نیست.

بازگشت

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

مجوز

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

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

selectAsCurrentPage()

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

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

// Select the first slide as the current page selection and replace any previous selection.
var 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

setSkipped(isSkipped)

تنظیم می کند که آیا اسلاید در حالت ارائه رد شود یا خیر.

پارامترها

نام تایپ کنید توضیحات
isSkipped Boolean True برای رد شدن از اسلاید در حالت ارائه.

مجوز

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

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

Slide فعلی را از اسلاید منبع آن جدا می کند. اگر این اسلاید پیوند داده نشده باشد، بدون ایجاد تغییر برمی گردد. 

var currentPresentation = SlidesApp.getActivePresentation();
var sourcePresentation = SlidesApp.openById('sourcePresentationId');
var sourceSlide = sourcePresentation.getSlides()[0];
var linkedSlide = currentPresentation.append(sourceSlide, SlidesApp.SlideLinkingMode.LINKED);

linkedSlide.unlink();

linkedSlide.getSourcePresentationId(); // returns null
linkedSlide.getSourceSlideObjectId();  // returns null
linkedSlide.getSlideLinkingMode();     // returns SlidesApp.SlideLinkingMode.NOT_LINKED

مجوز

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

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