Class Image

تصویر

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

روش ها

روش نوع برگشت شرح مختصر
align On Page(alignmentPosition) Image عنصر را با موقعیت تراز مشخص شده در صفحه تراز می کند.
bring Forward() Image عنصر صفحه را یک عنصر در صفحه جلو می آورد.
bring To Front() Image عنصر صفحه را به جلوی صفحه می آورد.
duplicate() Page Element عنصر صفحه را کپی می کند.
get As(contentType) Blob داده های داخل این شی را به عنوان یک حباب تبدیل به نوع محتوای مشخص شده برگردانید.
get Blob() Blob داده های داخل این تصویر را به صورت لکه برگردانید.
get Border() Border Border تصویر را برمی‌گرداند.
get Connection Sites() Connection Site[] لیستی از Connection Site را در عنصر صفحه، یا اگر عنصر صفحه هیچ سایت اتصالی نداشته باشد، یک لیست خالی برمی گرداند.
get Content Url() String یک URL برای تصویر دریافت می کند.
get Description() String توضیحات متن جایگزین عنصر صفحه را برمی گرداند.
get Height() Number ارتفاع عنصر را بر حسب نقاط بدست می‌آورد، که در زمانی که عنصر چرخش نداشته باشد، ارتفاع جعبه مرزی عنصر است.
get Inherent Height() Number ارتفاع ذاتی عنصر را بر حسب نقاط برمی‌گرداند.
get Inherent Width() Number عرض ذاتی عنصر را بر حسب نقاط برمی گرداند.
get Left() Number موقعیت افقی عنصر را در نقاطی که از گوشه سمت چپ بالای صفحه اندازه‌گیری می‌شود، زمانی که عنصر چرخش ندارد، برمی‌گرداند.
get Link() Link اگر پیوندی وجود نداشته باشد، Link برمی‌گرداند یا null .
get Object Id() String شناسه منحصر به فرد این شی را برمی گرداند.
get Page Element Type() Page Element Type نوع عنصر صفحه را برمی‌گرداند که به‌عنوان یک فهرست Page Element Type نمایش داده می‌شود.
get Parent Group() Group گروهی را که این عنصر صفحه به آن تعلق دارد برمی‌گرداند، یا اگر عنصر در یک گروه نباشد null برمی‌گرداند.
get Parent Page() Page صفحه ای را که این عنصر صفحه در آن است برمی گرداند.
get Parent Placeholder() Page Element عنصر صفحه والد مکان‌نما را برمی‌گرداند.
get Placeholder Index() Integer نمایه تصویر مکان‌نما را برمی‌گرداند.
get Placeholder Type() Placeholder Type نوع مکان‌نمای تصویر یا Placeholder Type.NONE را برمی‌گرداند اگر شکل یک مکان‌دار نباشد.
get Rotation() Number زاویه چرخش در جهت عقربه‌های ساعت عنصر را در اطراف مرکز آن بر حسب درجه برمی‌گرداند، جایی که صفر درجه به معنای عدم چرخش است.
get Source Url() String در صورت موجود بودن، نشانی اینترنتی منبع تصویر را دریافت می کند.
get Title() String عنوان متن جایگزین عنصر صفحه را برمی گرداند.
get Top() Number موقعیت عمودی عنصر را در نقاطی که از گوشه سمت چپ بالای صفحه اندازه گیری می شود، زمانی که عنصر چرخش ندارد، می گیرد.
get Transform() Affine Transform تبدیل عنصر صفحه را برمی گرداند.
get Width() Number عرض عنصر را بر حسب نقاط برمی‌گرداند، که عرض جعبه مرزی عنصر زمانی است که عنصر چرخش نداشته باشد.
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 توضیحات متن جایگزین عنصر صفحه را تنظیم می کند.
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 عنوان متن جایگزین عنصر صفحه را تنظیم می کند.
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)

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

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

پارامترها

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

بازگشت

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

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

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

بازگشت

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

مجوز

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

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

get Height()

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

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

بازگشت

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

مجوز

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

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

get Inherent Height()

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

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

بازگشت

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

مجوز

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

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

get Inherent Width()

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

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

بازگشت

Number - عرض ذاتی عنصر صفحه بر حسب نقطه یا اگر عنصر صفحه عرض نداشته باشد، 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 - در صورت عدم وجود پیوند 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()

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

مجوز

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

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

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

بازگشت

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

مجوز

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

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

get Placeholder Index()

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

بازگشت

Integer - ایندکس مکان‌نمای این تصویر، یا اگر تصویر جای‌بانی نباشد، 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 - زاویه چرخش در درجه بین 0 (شامل) و 360 (انحصاری).

مجوز

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

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

get Source Url()

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

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

بازگشت

String - URL تصویر یا در صورتی که تصویر دارای URL منبع نباشد، null .

مجوز

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

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

get Title()

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

بازگشت

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 .

مجوز

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

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

preconcatenate Transform(transform)

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

newTransform = argument * existingTransform;

به عنوان مثال، برای انتقال عناصر صفحه 36 نقطه به سمت چپ:

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

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

پارامترها

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

بازگشت

Image - این عنصر صفحه، برای زنجیر کردن.

مجوز

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

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

remove()

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

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

اگر یک Page Element نگهدارنده روی یک صفحه اصلی یا چیدمان حذف شود، هر جای جای خالی موروثی نیز حذف می شود.

مجوز

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

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

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

URL ارائه شده نباید بزرگتر از 2 کیلوبایت باشد.

پارامترها

نام تایپ کنید توضیحات
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)

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

این روش برای عناصر 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)

عنوان متن جایگزین عنصر صفحه را تنظیم می کند.

این روش برای عناصر 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 رشته ای که عنوان متن جایگزین را روی آن تنظیم کنید.

بازگشت

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)

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

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

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

برای جزئیات بیشتر در مورد اینکه چگونه تبدیل ها بر ظاهر بصری عناصر صفحه تأثیر می گذارند، به 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