Class Image

تصویر

یک Page Element که نشان دهنده یک تصویر است.

روش‌ها

روش نوع بازگشتی شرح مختصر
align On Page(alignmentPosition) Image عنصر را در موقعیت ترازبندی مشخص شده در صفحه تراز می‌کند.
bring Forward() Image عنصر صفحه را به اندازه یک عنصر به جلو در صفحه می‌آورد.
bring To Front() Image عنصر صفحه را به جلوی صفحه می‌آورد.
duplicate() Page Element عنصر صفحه را کپی می‌کند.
get As(contentType) Blob داده‌های درون این شیء را به صورت یک blob تبدیل‌شده به نوع محتوای مشخص‌شده، برمی‌گرداند.
get Blob() Blob داده‌های درون این تصویر را به صورت یک حباب (blob) برگردانید.
get Border() Border Border تصویر را برمی‌گرداند.
get Connection Sites() Connection Site[] لیستی از Connection Site ) را در عنصر صفحه برمی‌گرداند، یا اگر عنصر صفحه هیچ سایت اتصالی نداشته باشد، یک لیست خالی برمی‌گرداند.
get Content Url() String یک URL برای تصویر دریافت می‌کند.
get Description() String توضیحات متن جایگزین (alt text) عنصر صفحه را برمی‌گرداند.
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 Source Url() String|null در صورت وجود، آدرس اینترنتی منبع تصویر را دریافت می‌کند.
get Title() String عنوان متن جایگزین (alt text) عنصر صفحه را برمی‌گرداند.
get Top() Number موقعیت عمودی عنصر را بر حسب نقطه دریافت می‌کند، که از گوشه بالا سمت چپ صفحه، زمانی که عنصر هیچ چرخشی ندارد، اندازه‌گیری می‌شود.
get Transform() Affine Transform تبدیل عنصر صفحه را برمی‌گرداند.
get Width() Number|null عرض عنصر را بر حسب نقطه برمی‌گرداند، که برابر با عرض کادر اطراف عنصر است وقتی که عنصر هیچ چرخشی نداشته باشد.
preconcatenate Transform(transform) Image تبدیل ارائه شده را به تبدیل موجود عنصر صفحه از قبل الحاق می‌کند.
remove() void عنصر صفحه را حذف می‌کند.
remove Link() void یک Link حذف می‌کند.
replace(blobSource) Image این تصویر را با تصویری که توسط یک شیء Blob Source توصیف شده است، جایگزین می‌کند.
replace(blobSource, crop) Image این تصویر را با تصویری که توسط یک شیء Image توصیف می‌شود، جایگزین می‌کند و به صورت اختیاری تصویر را برای تناسب برش می‌دهد.
replace(imageUrl) Image این تصویر را با تصویر دیگری که از URL ارائه شده دانلود شده است، جایگزین می‌کند.
replace(imageUrl, crop) Image این تصویر را با تصویر دیگری که از URL ارائه شده دانلود شده است جایگزین می‌کند، و به صورت اختیاری تصویر را برای تناسب برش می‌دهد.
scale Height(ratio) Image ارتفاع عنصر را با نسبت مشخص شده مقیاس بندی می‌کند.
scale Width(ratio) Image عرض عنصر را با نسبت مشخص شده تغییر می‌دهد.
select() void فقط Page Element در ارائه فعال انتخاب می‌کند و هرگونه انتخاب قبلی را حذف می‌کند.
select(replace) void Page Element در ارائه فعال انتخاب می‌کند.
send Backward() Image عنصر صفحه را به اندازه یک عنصر به عقب در صفحه ارسال می‌کند.
send To Back() Image عنصر صفحه را به پشت صفحه ارسال می‌کند.
set Description(description) Image توضیحات متن جایگزین (alt text) عنصر صفحه را تنظیم می‌کند.
set Height(height) Image ارتفاع عنصر را بر حسب نقطه تنظیم می‌کند، که برابر با ارتفاع کادر اطراف عنصر است وقتی که عنصر هیچ چرخشی ندارد.
set Left(left) Image موقعیت افقی عنصر را بر حسب نقطه تنظیم می‌کند، که از گوشه بالا سمت چپ صفحه، زمانی که عنصر هیچ چرخشی ندارد، اندازه‌گیری می‌شود.
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) Image زاویه چرخش عنصر را در جهت عقربه‌های ساعت حول مرکز آن بر حسب درجه تنظیم می‌کند.
set Title(title) Image عنوان متن جایگزین (alt text) عنصر صفحه را تنظیم می‌کند.
set Top(top) Image موقعیت عمودی عنصر را بر حسب نقطه تنظیم می‌کند، که از گوشه بالا سمت چپ صفحه، زمانی که عنصر هیچ چرخشی ندارد، اندازه‌گیری می‌شود.
set Transform(transform) Image تبدیل عنصر صفحه را با تبدیل ارائه شده تنظیم می‌کند.
set Width(width) Image عرض عنصر را بر حسب نقطه تنظیم می‌کند، که همان عرض کادر اطراف عنصر است وقتی که عنصر هیچ چرخشی ندارد.

مستندات دقیق

align On Page(alignmentPosition)

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

پارامترها

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

بازگشت

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

bring Forward()

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

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

بازگشت

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

مجوز

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

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

bring To Front()

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

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

بازگشت

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

مجوز

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

  • 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 As(contentType)

داده‌های درون این شیء را به صورت یک blob تبدیل‌شده به نوع محتوای مشخص‌شده برمی‌گرداند. این متد پسوند مناسب را به نام فایل اضافه می‌کند - برای مثال، "myfile.pdf". با این حال، فرض می‌کند که بخشی از نام فایل که پس از آخرین نقطه (در صورت وجود) می‌آید، یک پسوند موجود است که باید جایگزین شود. در نتیجه، "ShoppingList.12.25.2014" به "ShoppingList.12.25.pdf" تبدیل می‌شود.

برای مشاهده سهمیه‌های روزانه برای تبدیل‌ها، به سهمیه‌های سرویس‌های گوگل مراجعه کنید. دامنه‌های جدید Google Workspace ممکن است موقتاً مشمول سهمیه‌های سختگیرانه‌تری باشند.

پارامترها

نام نوع توضیحات
content Type String نوع MIME برای تبدیل. برای اکثر blobها، 'application/pdf' تنها گزینه معتبر است. برای تصاویر با فرمت BMP، GIF، JPEG یا PNG، هر یک از 'image/bmp' ، 'image/gif' ، 'image/jpeg' یا 'image/png' نیز معتبر هستند. برای یک سند Google Docs، 'text/markdown' نیز معتبر است.

بازگشت

Blob - داده‌ها به عنوان یک حباب.

get Blob()

داده‌های درون این تصویر را به صورت یک حباب (blob) برگردانید.

بازگشت

Blob — داده‌های تصویر به صورت یک blob.

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

یک URL برای تصویر دریافت می‌کند.

این URL با حساب درخواست‌کننده برچسب‌گذاری شده است، بنابراین هر کسی که URL را داشته باشد، عملاً به عنوان درخواست‌کننده اصلی به تصویر دسترسی پیدا می‌کند. در صورت تغییر تنظیمات اشتراک‌گذاری ارائه، ممکن است دسترسی به تصویر از بین برود. URL برگردانده شده پس از مدت کوتاهی منقضی می‌شود.

بازگشت

String

مجوز

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

  • 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 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 Source Url()

در صورت وجود، آدرس اینترنتی منبع تصویر را دریافت می‌کند.

وقتی تصویری از طریق URL وارد می‌شود، URL ارائه شده هنگام درج تصویر را برمی‌گرداند.

بازگشت

String|null — آدرس اینترنتی تصویر یا اگر تصویر آدرس اینترنتی منبع نداشته باشد، null .

مجوز

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

  • 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 تبدیلی که قرار است روی تبدیل عنصر این صفحه از پیش الحاق شود.

بازگشت

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

مجوز

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

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

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

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

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

const image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0];
// Get the Drive image file with the given ID.
const driveImage = DriveApp.getFileById("123abc");
image.replace(driveImage);

پارامترها

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

بازگشت

Image — این Image پس از جایگزینی.

مجوز

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

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

replace(blobSource, crop)

این تصویر را با تصویری که توسط یک شیء Image توصیف می‌شود، جایگزین می‌کند و به صورت اختیاری تصویر را برای تناسب برش می‌دهد.

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

const image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0];
// Get the Drive image file with the given ID.
const driveImage = DriveApp.getFileById('123abc');
// Replace and crop the drive image.
image.replace(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(imageUrl)

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

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

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

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

پارامترها

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

بازگشت

Image — این Image پس از جایگزینی.

مجوز

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

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

replace(imageUrl, crop)

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

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

حجم URL ارائه شده نباید بیشتر از ۲ کیلوبایت باشد.

پارامترها

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

بازگشت

Image — این Image پس از جایگزینی.

مجوز

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

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

scale Height(ratio)

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

scale Width(ratio)

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

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

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

بازگشت

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

مجوز

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

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

send To Back()

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

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

بازگشت

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

مجوز

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

  • 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 رشته‌ای که قرار است توضیحات متن جایگزین روی آن تنظیم شود.

بازگشت

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

مجوز

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

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

set Height(height)

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

set Left(left)

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

پارامترها

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

بازگشت

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

مجوز

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

  • 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 زاویه چرخش جدید در جهت عقربه‌های ساعت برای تنظیم، بر حسب درجه.

بازگشت

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

مجوز

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

  • 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) روی آن تنظیم شود.

بازگشت

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

مجوز

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

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

set Top(top)

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

پارامترها

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

بازگشت

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

مجوز

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

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

set Transform(transform)

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

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

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

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

پارامترها

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

بازگشت

Image — این عنصر، برای زنجیره‌سازی.

مجوز

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

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

set Width(width)

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

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

پارامترها

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

بازگشت

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

مجوز

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

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