Class Slide

اسلاید

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

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

روش ها

روش نوع برگشت شرح مختصر
duplicate() Slide اسلاید را کپی می کند.
get Background() Page Background پس زمینه صفحه را دریافت می کند.
get Color Scheme() Color Scheme Color Scheme مرتبط با صفحه را دریافت می کند.
get Groups() Group[] فهرست اشیاء Group را در صفحه برمی گرداند.
get Images() Image[] لیست اشیاء Image را در صفحه برمی گرداند.
get Layout() Layout طرحی که اسلاید بر اساس آن است را دریافت می کند یا اگر اسلاید بر اساس طرح بندی نباشد، null .
get Lines() Line[] لیست اشیاء Line را در صفحه برمی گرداند.
get Notes Page() Notes Page صفحه یادداشت های مرتبط با اسلاید را برمی گرداند.
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 Slide Linking Mode() Slide Linking Mode یک Slide Linking Mode را برمی‌گرداند که نشان می‌دهد آیا اسلاید به اسلاید دیگری مرتبط است یا خیر.
get Source Presentation Id() String در صورتی که اسلاید null داده نشده باشد، شناسه Presentation منبع را برمی‌گرداند.
get Source Slide Object Id() String شناسه اسلاید منبع را برمی‌گرداند یا اگر اسلاید پیوند داده نشده باشد، null برمی‌گرداند.
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 ارائه شده را در صفحه درج می کند.
is Skipped() Boolean نشان می دهد که آیا اسلاید در حالت ارائه رد شده است یا خیر.
move(index) void اسلاید را به نمایه مشخص شده منتقل کنید.
refresh Slide() void اسلاید را تازه می کند تا هرگونه تغییر ایجاد شده در اسلاید منبع پیوند شده را منعکس کند.
remove() void صفحه را حذف می کند.
replace All Text(findText, replaceText) Integer همه نمونه‌های متنی که متن یافتن را با متن جایگزین مطابقت دارد جایگزین می‌کند.
replace All Text(findText, replaceText, matchCase) Integer همه نمونه‌های متنی که متن یافتن را با متن جایگزین مطابقت دارد جایگزین می‌کند.
select As Current Page() void Page در ارائه فعال را به عنوان current page selection انتخاب می کند و هر انتخاب قبلی را حذف می کند.
set Skipped(isSkipped) void تنظیم می کند که آیا اسلاید در حالت ارائه رد شود یا خیر.
unlink() void Slide فعلی را از اسلاید منبع آن جدا می کند.

مستندات دقیق

duplicate()

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

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

بازگشت

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

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

بازگشت

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 Notes Page()

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

بازگشت

Notes Page

مجوز

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

  • 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 Slide Linking Mode()

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

بازگشت

Slide Linking Mode - حالت پیوند اسلاید.

مجوز

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

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

get Source Presentation Id()

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

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

بازگشت

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

مجوز

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

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

get Source Slide Object Id()

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

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

بازگشت

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

مجوز

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

  • 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

is Skipped()

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

بازگشت

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

refresh Slide()

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

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

const currentPresentation = SlidesApp.getActivePresentation();
const sourcePresentation = SlidesApp.openById('sourcePresentationId');
const sourceSlide = sourcePresentation.getSlides()[0];
const 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

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

set Skipped(isSkipped)

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

پارامترها

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

مجوز

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

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

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

const currentPresentation = SlidesApp.getActivePresentation();
const sourcePresentation = SlidesApp.openById('sourcePresentationId');
const sourceSlide = sourcePresentation.getSlides()[0];
const 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