تصویری را برای افزودن به یک سلول نشان می دهد. برای افزودن یک تصویر به یک سلول، باید با استفاده از SpreadsheetApp.newCellImage() و CellImageBuilder یک مقدار تصویر جدید برای تصویر ایجاد کنید. سپس می توانید از Range.setValue(value) یا Range.setValues(values) برای اضافه کردن مقدار تصویر به سلول استفاده کنید.
خواص
| ویژگی | تایپ کنید | شرح |
|---|---|---|
valueType | ValueType | فیلدی که روی ValueType.IMAGE تنظیم شده است که نشان دهنده نوع مقدار تصویر است. |
مواد و روش ها
| روش | نوع برگشت | توضیح مختصر |
|---|---|---|
getAltTextDescription() | String | توضیحات متن جایگزین را برای این تصویر برمی گرداند. |
getAltTextTitle() | String | عنوان متن جایگزین را برای این تصویر برمی گرداند. |
getContentUrl() | String | URL میزبانی شده توسط Google را به تصویر برمی گرداند. |
getUrl() | String | آدرس منبع تصویر را دریافت می کند. اگر URL در دسترس نباشد، null برمی‌گرداند. |
toBuilder() | CellImageBuilder | سازنده ای ایجاد می کند که یک تصویر را به یک نوع مقدار تصویر تبدیل می کند تا بتوانید آن را در یک سلول قرار دهید. |
مستندات دقیق
getAltTextDescription()
توضیحات متن جایگزین را برای این تصویر برمی گرداند.
برگشت
String - توضیحات متن جایگزین.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getAltTextTitle()
عنوان متن جایگزین را برای این تصویر برمی گرداند.
برگشت
String - عنوان متن جایگزین.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getContentUrl()
یک URL میزبانی شده توسط Google را به تصویر برمی گرداند. این URL با حساب درخواست کننده برچسب گذاری شده است، بنابراین هر کسی که URL را داشته باشد به عنوان درخواست کننده اصلی به تصویر دسترسی پیدا می کند. در صورت تغییر تنظیمات اشتراک‌گذاری صفحه‌گسترده، ممکن است دسترسی به تصویر از بین برود. URL برگشتی پس از مدت کوتاهی منقضی می شود.
برگشت
String - نشانی اینترنتی تصویر که توسط گوگل میزبانی شده است.
getUrl()
آدرس منبع تصویر را دریافت می کند. اگر URL در دسترس نباشد، null برمی‌گرداند. اگر تصویر توسط URL با استفاده از یک API درج شده باشد، این روش URL ارائه شده در هنگام درج تصویر را برمی گرداند.
برگشت
String - URL تصویر در صورت موجود بودن؛ اگر تصویر در دسترس نباشد یا URL منبع نداشته باشد، null برمی‌گرداند.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
toBuilder()
سازنده ای ایجاد می کند که یک تصویر را به یک نوع مقدار تصویر تبدیل می کند تا بتوانید آن را در یک سلول قرار دهید. قبل از اینکه یک تصویر در یک سلول قرار گیرد، باید به عنوان یک نوع مقدار تصویر ایجاد شود. سپس می توانید با استفاده از Range.setValue(value) یا Range.setValues(values) آن را به یک سلول اضافه کنید.
برگشت
CellImageBuilder - سازنده ای که یک نوع مقدار تصویر را بر اساس ویژگی های تصویر داده شده ایجاد می کند.