Class Shape

شکل

یک Page Element که نشان‌دهنده یک شکل عمومی است که طبقه‌بندی خاص‌تری ندارد. شامل کادرهای متنی، مستطیل‌ها و سایر اشکال از پیش تعریف شده می‌شود.

روش‌ها

روش نوع بازگشتی شرح مختصر
align On Page(alignmentPosition) Shape عنصر را در موقعیت ترازبندی مشخص شده در صفحه تراز می‌کند.
bring Forward() Shape عنصر صفحه را به اندازه یک عنصر به جلو در صفحه می‌آورد.
bring To Front() Shape عنصر صفحه را به جلوی صفحه می‌آورد.
duplicate() Page Element عنصر صفحه را کپی می‌کند.
get Autofit() Autofit |null میزان Autofit متن درون این شکل را برمی‌گرداند.
get Border() Border Border شکل را برمی‌گرداند.
get Connection Sites() Connection Site[] لیستی از Connection Site ) را در عنصر صفحه برمی‌گرداند، یا اگر عنصر صفحه هیچ سایت اتصالی نداشته باشد، یک لیست خالی برمی‌گرداند.
get Content Alignment() Content Alignment Content Alignment متن درون شکل را برمی‌گرداند.
get Description() String توضیحات متن جایگزین (alt text) عنصر صفحه را برمی‌گرداند.
get Fill() Fill مقدار Fill ) شکل را برمی‌گرداند.
get Height() Number|null ارتفاع عنصر را بر حسب نقطه دریافت می‌کند، که برابر با ارتفاع کادر محصورکننده عنصر در زمانی است که عنصر هیچ چرخشی ندارد.
get Inherent Height() Number|null ارتفاع ذاتی عنصر را بر حسب نقطه برمی‌گرداند.
get Inherent Width() Number|null عرض ذاتی عنصر را بر حسب نقطه برمی‌گرداند.
get Left() Number موقعیت افقی عنصر را بر حسب نقطه برمی‌گرداند، که از گوشه بالا سمت چپ صفحه، زمانی که عنصر هیچ چرخشی ندارد، اندازه‌گیری می‌شود.
get Link() Link |null Link را برمی‌گرداند و در صورت عدم وجود لینک، null برمی‌گرداند.
get Object Id() String شناسه منحصر به فرد این شیء را برمی‌گرداند.
get Page Element Type() Page Element Type نوع عنصر صفحه را برمی‌گرداند، که به صورت یک enum Page Element Type نمایش داده می‌شود.
get Parent Group() Group |null گروهی که این عنصر صفحه به آن تعلق دارد را برمی‌گرداند، یا اگر عنصر در گروهی نباشد null برمی‌گرداند.
get Parent Page() Page صفحه‌ای را که این عنصر صفحه در آن قرار دارد، برمی‌گرداند.
get Parent Placeholder() Page Element |null عنصر صفحه والدِ مربوط به placeholder را برمی‌گرداند.
get Placeholder Index() Integer|null اندیس مکان‌نما (placeholder) شکل را برمی‌گرداند.
get Placeholder Type() Placeholder Type نوع نگهدارنده شکل یا اگر شکل نگهدارنده نباشد، Placeholder Type.NONE را برمی‌گرداند.
get Rotation() Number زاویه چرخش عنصر در جهت عقربه‌های ساعت حول مرکزش را بر حسب درجه برمی‌گرداند، که در آن صفر درجه به معنای عدم چرخش است.
get Shape Type() Shape Type نوع شکل را برمی‌گرداند.
get Text() Text Range محتوای متن شکل را برمی‌گرداند.
get Title() String عنوان متن جایگزین (alt text) عنصر صفحه را برمی‌گرداند.
get Top() Number موقعیت عمودی عنصر را بر حسب نقطه دریافت می‌کند، که از گوشه بالا سمت چپ صفحه، زمانی که عنصر هیچ چرخشی ندارد، اندازه‌گیری می‌شود.
get Transform() Affine Transform تبدیل عنصر صفحه را برمی‌گرداند.
get Width() Number|null عرض عنصر را بر حسب نقطه برمی‌گرداند، که برابر با عرض کادر اطراف عنصر است وقتی که عنصر هیچ چرخشی نداشته باشد.
preconcatenate Transform(transform) Shape تبدیل ارائه شده را به تبدیل موجود عنصر صفحه از قبل الحاق می‌کند.
remove() void عنصر صفحه را حذف می‌کند.
remove Link() void یک Link حذف می‌کند.
replace With Image(blobSource) Image این شکل را با تصویری که توسط Blob Source ارائه شده است، جایگزین می‌کند.
replace With Image(blobSource, crop) Image این شکل را با تصویری که توسط Blob Source ارائه شده است، جایگزین می‌کند.
replace With Image(imageUrl) Image این شکل را با یک تصویر جایگزین می‌کند.
replace With Image(imageUrl, crop) Image این شکل را با یک تصویر جایگزین می‌کند.
replace With Sheets Chart(sourceChart) Sheets Chart این شکل را با نمودار Google Sheets جایگزین می‌کند.
replace With Sheets Chart As Image(sourceChart) Image این شکل را با تصویری از نمودار Google Sheets جایگزین می‌کند.
scale Height(ratio) Shape ارتفاع عنصر را با نسبت مشخص شده مقیاس بندی می‌کند.
scale Width(ratio) Shape عرض عنصر را با نسبت مشخص شده تغییر می‌دهد.
select() void فقط Page Element در ارائه فعال انتخاب می‌کند و هرگونه انتخاب قبلی را حذف می‌کند.
select(replace) void Page Element در ارائه فعال انتخاب می‌کند.
send Backward() Shape عنصر صفحه را به اندازه یک عنصر به عقب در صفحه ارسال می‌کند.
send To Back() Shape عنصر صفحه را به پشت صفحه ارسال می‌کند.
set Content Alignment(contentAlignment) Shape Content Alignment متن درون شکل را تنظیم می‌کند.
set Description(description) Shape توضیحات متن جایگزین (alt text) عنصر صفحه را تنظیم می‌کند.
set Height(height) Shape ارتفاع عنصر را بر حسب نقطه تنظیم می‌کند، که برابر با ارتفاع کادر اطراف عنصر است وقتی که عنصر هیچ چرخشی ندارد.
set Left(left) Shape موقعیت افقی عنصر را بر حسب نقطه تنظیم می‌کند، که از گوشه بالا سمت چپ صفحه، زمانی که عنصر هیچ چرخشی ندارد، اندازه‌گیری می‌شود.
set Link Slide(slideIndex) Link با استفاده از اندیس مبتنی بر صفر اسلاید، Link به Slide داده شده تنظیم می‌کند.
set Link Slide(slide) Link یک Link به Slide داده شده تنظیم می‌کند، لینک توسط شناسه اسلاید داده شده تنظیم می‌شود.
set Link Slide(slidePosition) Link با استفاده از موقعیت نسبی اسلاید، Link به Slide داده شده تنظیم می‌کند.
set Link Url(url) Link یک Link به رشته URL غیر خالی داده شده تنظیم می‌کند.
set Rotation(angle) Shape زاویه چرخش عنصر را در جهت عقربه‌های ساعت حول مرکز آن بر حسب درجه تنظیم می‌کند.
set Title(title) Shape عنوان متن جایگزین (alt text) عنصر صفحه را تنظیم می‌کند.
set Top(top) Shape موقعیت عمودی عنصر را بر حسب نقطه تنظیم می‌کند، که از گوشه بالا سمت چپ صفحه، زمانی که عنصر هیچ چرخشی ندارد، اندازه‌گیری می‌شود.
set Transform(transform) Shape تبدیل عنصر صفحه را با تبدیل ارائه شده تنظیم می‌کند.
set Width(width) Shape عرض عنصر را بر حسب نقطه تنظیم می‌کند، که همان عرض کادر اطراف عنصر است وقتی که عنصر هیچ چرخشی ندارد.

مستندات دقیق

align On Page(alignmentPosition)

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

پارامترها

نام نوع توضیحات
alignment Position Alignment Position موقعیتی که این عنصر صفحه در صفحه با آن ترازبندی می‌شود.

بازگشت

Shape - این عنصر صفحه، برای زنجیره‌سازی.

bring Forward()

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

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

بازگشت

Shape - این عنصر صفحه، برای زنجیره‌سازی.

مجوز

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

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

bring To Front()

عنصر صفحه را به جلوی صفحه می‌آورد.

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

بازگشت

Shape - این عنصر صفحه، برای زنجیره‌سازی.

مجوز

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

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

duplicate()

عنصر صفحه را کپی می‌کند.

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

بازگشت

Page Element - کپی جدید این عنصر صفحه.

مجوز

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

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

get Autofit()

میزان Autofit متن درون این شکل را برمی‌گرداند. اگر شکل متن را پشتیبانی نکند، این null است.

بازگشت

Autofit |null — تناسب خودکار متن درون این شکل.

مجوز

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

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

get Border()

Border شکل را برمی‌گرداند.

بازگشت

Border — تنظیمات حاشیه این شکل.

مجوز

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

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

get Connection Sites()

لیستی از Connection Site ) را در عنصر صفحه برمی‌گرداند، یا اگر عنصر صفحه هیچ سایت اتصالی نداشته باشد، یک لیست خالی برمی‌گرداند.

بازگشت

Connection Site[] — فهرست سایت‌های اتصال، که اگر این عنصر هیچ سایت اتصالی نداشته باشد، ممکن است خالی باشد.

مجوز

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

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

get Content Alignment()

Content Alignment متن درون شکل را برمی‌گرداند.

بازگشت

Content Alignment — ترازبندی متن درون این شکل.

مجوز

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

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

get Description()

توضیحات متن جایگزین (alt text) عنصر صفحه را برمی‌گرداند. این توضیحات با عنوان ترکیب می‌شود تا متن جایگزین نمایش داده شود و خوانده شود.

بازگشت

String - توضیحات متن جایگزین عنصر صفحه.

مجوز

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

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

get Fill()

مقدار Fill ) شکل را برمی‌گرداند.

بازگشت

Fill — تنظیمات پر کردن این شکل.

مجوز

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

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

get Height()

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

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

بازگشت

Number|null — ارتفاع ذاتی عنصر صفحه بر حسب نقطه، یا null اگر عنصر صفحه ارتفاع نداشته باشد.

مجوز

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

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

get Inherent Height()

ارتفاع ذاتی عنصر را بر حسب نقطه برمی‌گرداند.

تبدیل عنصر صفحه نسبت به اندازه ذاتی آن است. از اندازه ذاتی به همراه تبدیل عنصر برای تعیین ظاهر بصری نهایی عنصر استفاده کنید.

بازگشت

Number|null — ارتفاع ذاتی عنصر صفحه بر حسب نقطه، یا null اگر عنصر صفحه ارتفاع نداشته باشد.

مجوز

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

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

get Inherent Width()

عرض ذاتی عنصر را بر حسب نقطه برمی‌گرداند.

تبدیل عنصر صفحه نسبت به اندازه ذاتی آن است. از اندازه ذاتی به همراه تبدیل عنصر برای تعیین ظاهر بصری نهایی عنصر استفاده کنید.

بازگشت

Number|null — عرض ذاتی عنصر صفحه بر حسب نقطه، یا null اگر عنصر صفحه عرض نداشته باشد.

مجوز

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

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

get Left()

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

بازگشت

Number - موقعیت افقی این عنصر بر حسب نقطه، از گوشه بالا سمت چپ صفحه.

مجوز

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

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

Link را برمی‌گرداند و در صورت عدم وجود لینک، null برمی‌گرداند.

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const link = shape.getLink();
if (link != null) {
  Logger.log(`Shape has a link of type: ${link.getLinkType()}`);
}

بازگشت

Link |null — Link یا اگر لینکی وجود نداشته باشد null .

مجوز

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

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

نوع عنصر صفحه را برمی‌گرداند، که به صورت یک enum Page Element Type نمایش داده می‌شود.

بازگشت

Page Element Type — نوع عنصر صفحه.

مجوز

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

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

get Parent Group()

گروهی که این عنصر صفحه به آن تعلق دارد را برمی‌گرداند، یا اگر عنصر در گروهی نباشد null برمی‌گرداند.

بازگشت

Group |null — گروهی که این عنصر صفحه به آن تعلق دارد، یا null .

مجوز

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

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

get Parent Page()

صفحه‌ای را که این عنصر صفحه در آن قرار دارد، برمی‌گرداند.

بازگشت

Page - صفحه‌ای که این عنصر در آن قرار دارد.

مجوز

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

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

get Parent Placeholder()

عنصر صفحه والدِ placeholder را برمی‌گرداند. اگر شکل یک placeholder نباشد یا والد نداشته باشد، null را برمی‌گرداند.

بازگشت

Page Element |null — عنصر صفحه والدِ این نگهدارنده‌ی شکل، یا اگر این شکل یک نگهدارنده‌ی شکل نباشد یا والد نداشته باشد، null .

مجوز

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

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

get Placeholder Index()

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

بازگشت

Integer|null — اندیس جای‌نگهدار این شکل، یا null اگر شکل جای‌نگهدار نباشد.

مجوز

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

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

get Placeholder Type()

نوع نگهدارنده شکل یا اگر شکل نگهدارنده نباشد، Placeholder Type.NONE را برمی‌گرداند.

بازگشت

Placeholder Type - نوع جایگذاری این شکل.

مجوز

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

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

get Rotation()

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

بازگشت

Number — زاویه چرخش بر حسب درجه بین ۰ (شامل) و ۳۶۰ (به‌جز)

مجوز

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

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

get Shape Type()

نوع شکل را برمی‌گرداند.

بازگشت

Shape Type — نوع این شکل.

get Text()

محتوای متن شکل را برمی‌گرداند.

متن درون یک شکل همیشه با یک کاراکتر خط جدید خاتمه می‌یابد.

بازگشت

Text Range - محتوای متن این شکل.

مجوز

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

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

get Title()

عنوان متن جایگزین (alt text) عنصر صفحه را برمی‌گرداند. عنوان با توضیحات ترکیب می‌شود تا متن جایگزین نمایش داده شود و خوانده شود.

بازگشت

String - عنوان متن جایگزین عنصر صفحه.

مجوز

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

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

get Top()

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

بازگشت

Number - موقعیت عمودی این عنصر بر حسب نقطه، از گوشه بالا سمت چپ صفحه.

مجوز

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

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

get Transform()

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

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

بازگشت

Affine Transform - تبدیل عنصر صفحه.

مجوز

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

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

get Width()

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

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

بازگشت

Number|null — عرض ذاتی عنصر صفحه بر حسب نقطه، یا null اگر عنصر صفحه عرض نداشته باشد.

مجوز

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

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

preconcatenate Transform(transform)

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

newTransform = argument * existingTransform;

برای مثال، برای جابجایی عناصر یک صفحه به اندازه ۳۶ نقطه به سمت چپ:

const element = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
element.preconcatenateTransform(
    SlidesApp.newAffineTransformBuilder().setTranslateX(-36.0).build(),
);

همچنین می‌توانید transform عنصر صفحه را با set Transform(transform) جایگزین کنید.

پارامترها

نام نوع توضیحات
transform Affine Transform تبدیلی که قرار است روی تبدیل عنصر این صفحه از پیش الحاق شود.

بازگشت

Shape - این عنصر صفحه، برای زنجیره‌سازی.

مجوز

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

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

remove()

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

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

اگر یک Page Element جانگهدار (placeholder) در یک صفحه اصلی یا طرح‌بندی حذف شود، هر جانگهدار خالی ارث‌بر نیز حذف می‌شود.

مجوز

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

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

یک Link حذف می‌کند.

const slides = SlidesApp.getActivePresentation().getSlides();
slides[1].getShapes()[0].removeLink();

replace With Image(blobSource)

این شکل را با تصویری که توسط Blob Source ارائه شده است، جایگزین می‌کند.

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

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

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

پارامترها

نام نوع توضیحات
blob Source Blob Source داده‌های تصویر.

بازگشت

Image — Image که جایگزین شکل شده است.

مجوز

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

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

replace With Image(blobSource, crop)

این شکل را با تصویری که توسط Blob Source ارائه شده است، جایگزین می‌کند.

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

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
// Get the Drive image file with the given ID.
const driveImage = DriveApp.getFileById('123abc');
// Replace and crop the replaced image.
shape.replaceWithImage(driveImage, true);

پارامترها

نام نوع توضیحات
blob Source Blob Source داده‌های تصویر.
crop Boolean اگر true ، تصویر را برش می‌دهد تا با اندازه شکل موجود متناسب شود. در غیر این صورت، تصویر مقیاس‌بندی و در مرکز قرار می‌گیرد.

بازگشت

Image — Image که جایگزین شکل شده است.

مجوز

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

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

replace With Image(imageUrl)

این شکل را با یک تصویر جایگزین می‌کند.

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

URL ارائه شده باید به صورت عمومی قابل دسترسی باشد و حجم آن از ۲ کیلوبایت بیشتر نباشد. خود URL به همراه تصویر ذخیره شده و از طریق Image.getSourceUrl() نمایش داده می‌شود.

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

پارامترها

نام نوع توضیحات
image Url String آدرس اینترنتی (URL) تصویر برای دانلود تصویر.

بازگشت

Image — Image که جایگزین شکل شده است.

مجوز

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

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

replace With Image(imageUrl, crop)

این شکل را با یک تصویر جایگزین می‌کند.

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

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

پارامترها

نام نوع توضیحات
image Url String آدرس اینترنتی (URL) تصویر برای دانلود تصویر.
crop Boolean اگر true ، تصویر را برش می‌دهد تا با اندازه شکل موجود متناسب شود. در غیر این صورت، تصویر مقیاس‌بندی و در مرکز قرار می‌گیرد.

بازگشت

Image — Image که جایگزین شکل شده است.

مجوز

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

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

replace With Sheets Chart(sourceChart)

این شکل را با نمودار Google Sheets جایگزین می‌کند.

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

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart.
const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
shape.replaceWithSheetsChart(chart);

پارامترها

نام نوع توضیحات
source Chart Embedded Chart نمودار در یک صفحه گسترده که جایگزین شکل می‌شود.

بازگشت

Sheets Chart - نموداری که جایگزین شکل شد.

مجوز

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

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

replace With Sheets Chart As Image(sourceChart)

این شکل را با تصویری از نمودار Google Sheets جایگزین می‌کند.

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

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

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart as an image.
const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
shape.replaceWithSheetsChartAsImage(chart);

پارامترها

نام نوع توضیحات
source Chart Embedded Chart نمودار در یک صفحه گسترده که جایگزین شکل می‌شود.

بازگشت

Image — تصویر نموداری که جایگزین شکل شده است.

مجوز

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

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

scale Height(ratio)

ارتفاع عنصر را با نسبت مشخص شده مقیاس‌بندی می‌کند. ارتفاع عنصر، ارتفاع کادر اطراف آن است، زمانی که عنصر هیچ چرخشی ندارد.

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

پارامترها

نام نوع توضیحات
ratio Number نسبتی که ارتفاع این عنصر صفحه را بر اساس آن مقیاس‌بندی می‌کند.

بازگشت

Shape - این عنصر صفحه، برای زنجیره‌سازی.

مجوز

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

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

scale Width(ratio)

عرض عنصر را با نسبت مشخص شده مقیاس‌بندی می‌کند. عرض عنصر، عرض کادر اطراف آن است، زمانی که عنصر هیچ چرخشی ندارد.

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

پارامترها

نام نوع توضیحات
ratio Number نسبتی که عرض این عنصر صفحه را بر اساس آن مقیاس‌بندی می‌کند.

بازگشت

Shape - این عنصر صفحه، برای زنجیره‌سازی.

مجوز

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

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

select()

فقط Page Element در ارائه فعال انتخاب می‌کند و هرگونه انتخاب قبلی را حذف می‌کند. این همان فراخوانی select(replace) با true است.

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

این، Page والد Page Element را به عنوان current page selection تعیین می‌کند.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const pageElement = slide.getPageElements()[0];
// Only select this page element and replace any previous selection.
pageElement.select();

مجوز

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

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

select(replace)

Page Element در ارائه فعال انتخاب می‌کند.

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

برای انتخاب فقط Page Element و حذف هرگونه انتخاب قبلی، مقدار true را به این متد ارسال کنید. این روش همچنین Page والد Page Element را به عنوان current page selection تنظیم می‌کند.

برای انتخاب چندین شیء Page Element مقدار false را ارسال کنید. اشیاء Page Element باید در یک Page باشند.

هنگام انتخاب یک عنصر صفحه با استفاده از پارامتر false ، شرایط زیر باید رعایت شود:

  1. Page والد شیء Page Element باید current page selection باشد.
  2. نباید چندین شیء Page انتخاب شده باشد.

برای اطمینان از این موضوع، رویکرد ترجیحی این است که ابتدا Page والد را با استفاده از Page.selectAsCurrentPage() انتخاب کنید و سپس عناصر صفحه را در آن صفحه انتخاب کنید. 

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// First select the slide page, as the current page selection.
slide.selectAsCurrentPage();
// Then select all the page elements in the selected slide page.
const pageElements = slide.getPageElements();
for (let i = 0; i < pageElements.length; i++) {
  pageElements[i].select(false);
}

پارامترها

نام نوع توضیحات
replace Boolean اگر مقدار true ، انتخاب جایگزین هر انتخاب قبلی می‌شود؛ در غیر این صورت، انتخاب به هر انتخاب قبلی اضافه می‌شود.

مجوز

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

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

send Backward()

عنصر صفحه را به اندازه یک عنصر به عقب در صفحه ارسال می‌کند.

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

بازگشت

Shape - این عنصر صفحه، برای زنجیره‌سازی.

مجوز

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

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

send To Back()

عنصر صفحه را به پشت صفحه ارسال می‌کند.

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

بازگشت

Shape - این عنصر صفحه، برای زنجیره‌سازی.

مجوز

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

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

set Content Alignment(contentAlignment)

Content Alignment متن درون شکل را تنظیم می‌کند.

این روش به طور خودکار ویژگی‌های تنظیم خودکار متن را روی شکل‌های به‌روزرسانی‌شده غیرفعال می‌کند.

پارامترها

نام نوع توضیحات
content Alignment Content Alignment ترازبندی برای تنظیم.

بازگشت

Shape — این شکل، برای زنجیر کردن.

مجوز

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

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

set Description(description)

توضیحات متن جایگزین (alt text) عنصر صفحه را تنظیم می‌کند.

این روش برای عناصر Group پشتیبانی نمی‌شود. 

// Set the first page element's alt text description to "new alt text
// description".
const pageElement =
    SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setDescription('new alt text description');
Logger.log(pageElement.getDescription());

پارامترها

نام نوع توضیحات
description String رشته‌ای که قرار است توضیحات متن جایگزین روی آن تنظیم شود.

بازگشت

Shape - عنصر این صفحه.

مجوز

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

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

set Height(height)

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

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

پارامترها

نام نوع توضیحات
height Number ارتفاع جدید این عنصر صفحه که باید تنظیم شود، بر حسب نقطه.

بازگشت

Shape - این عنصر صفحه، برای زنجیره‌سازی.

مجوز

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

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

set Left(left)

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

پارامترها

نام نوع توضیحات
left Number موقعیت افقی جدید برای تنظیم، بر حسب نقطه.

بازگشت

Shape - این عنصر صفحه، برای زنجیره‌سازی.

مجوز

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

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

set Link Slide(slideIndex)

با استفاده از اندیس مبتنی بر صفر اسلاید، Link به Slide داده شده تنظیم می‌کند. 

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(0);

پارامترها

نام نوع توضیحات
slide Index Integer اندیس مبتنی بر صفر برای اسلاید.

بازگشت

Link — Link که تنظیم شده است.

مجوز

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

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

set Link Slide(slide)

یک Link به Slide داده شده تنظیم می‌کند، لینک توسط شناسه اسلاید داده شده تنظیم می‌شود. 

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(slides[0]);

پارامترها

نام نوع توضیحات
slide Slide Slide که قرار است لینک شود.

بازگشت

Link — Link که تنظیم شده است.

مجوز

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

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

set Link Slide(slidePosition)

با استفاده از موقعیت نسبی اسلاید، Link به Slide داده شده تنظیم می‌کند. 

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);

پارامترها

نام نوع توضیحات
slide Position Slide Position Slide Position نسبی.

بازگشت

Link — Link که تنظیم شده است.

مجوز

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

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

set Link Url(url)

یک Link به رشته URL غیر خالی داده شده تنظیم می‌کند. 

// Set a link to the URL.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkUrl('https://slides.google.com');

پارامترها

نام نوع توضیحات
url String رشته‌ی URL.

بازگشت

Link — Link که تنظیم شده است.

مجوز

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

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

set Rotation(angle)

زاویه چرخش عنصر را در جهت عقربه‌های ساعت حول مرکز آن بر حسب درجه تنظیم می‌کند.

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

پارامترها

نام نوع توضیحات
angle Number زاویه چرخش جدید در جهت عقربه‌های ساعت برای تنظیم، بر حسب درجه.

بازگشت

Shape - این عنصر صفحه، برای زنجیره‌سازی.

مجوز

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

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

set Title(title)

عنوان متن جایگزین (alt text) عنصر صفحه را تنظیم می‌کند.

این روش برای عناصر Group پشتیبانی نمی‌شود. 

// Set the first page element's alt text title to "new alt text title".
const pageElement =
    SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setTitle('new alt text title');
Logger.log(pageElement.getTitle());

پارامترها

نام نوع توضیحات
title String رشته‌ای که قرار است عنوان متن جایگزین (alt text) روی آن تنظیم شود.

بازگشت

Shape - عنصر این صفحه.

مجوز

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

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

set Top(top)

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

پارامترها

نام نوع توضیحات
top Number موقعیت عمودی جدید برای تنظیم، بر حسب نقطه.

بازگشت

Shape - این عنصر صفحه، برای زنجیره‌سازی.

مجوز

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

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

set Transform(transform)

تبدیل عنصر صفحه را با تبدیل ارائه شده تنظیم می‌کند.

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

به‌روزرسانی تبدیل یک عنصر صفحه که در یک گروه قرار دارد، فقط تبدیل آن عنصر صفحه را تغییر می‌دهد؛ این کار بر تبدیل‌های گروه یا سایر عناصر صفحه در گروه تأثیری نمی‌گذارد.

برای جزئیات بیشتر در مورد چگونگی تأثیر transformها بر ظاهر بصری عناصر صفحه، به get Transform() مراجعه کنید.

پارامترها

نام نوع توضیحات
transform Affine Transform تبدیلی که برای این عنصر صفحه تنظیم شده است.

بازگشت

Shape - این عنصر، برای زنجیر کردن.

مجوز

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

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

set Width(width)

عرض عنصر را بر حسب نقطه تنظیم می‌کند، که همان عرض کادر اطراف عنصر است وقتی که عنصر هیچ چرخشی ندارد.

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

پارامترها

نام نوع توضیحات
width Number عرض جدید این عنصر صفحه که باید تنظیم شود، بر حسب نقطه.

بازگشت

Shape - این عنصر صفحه، برای زنجیره‌سازی.

مجوز

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

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