Class CellImageBuilder

CellImageBuilder

בנאי של CellImage. הכלי הזה יוצר את ערך התמונה שנדרש כדי להוסיף תמונה לתא.

תכונות

נכסתיאורהתיאור
valueTypeValueTypeשדה שמוגדר בתור ValueType.IMAGE, ומייצג את סוג הערך של התמונה.

שיטות

שיטהסוג הערך שמוחזרתיאור קצר
build()CellImageיוצרת את סוג הערך של התמונה הדרוש להוספת תמונה לתא.
getAltTextDescription()Stringהפונקציה מחזירה את תיאור הטקסט החלופי לתמונה הזו.
getAltTextTitle()Stringמחזירה את כותרת הטקסט החלופי לתמונה זו.
getContentUrl()Stringמחזירה לתמונה כתובת URL שמתארחת ב-Google.
getUrl()Stringהפונקציה מחזירה את כתובת ה-URL של התמונה המקורית, ומחזירה את הערך null אם כתובת ה-URL לא זמינה.
setAltTextDescription(description)CellImageמגדיר את תיאור הטקסט החלופי לתמונה הזו.
setAltTextTitle(title)CellImageמגדיר את כותרת הטקסט החלופי לתמונה הזו.
setSourceUrl(url)CellImageBuilderמגדיר את כתובת ה-URL של מקור התמונה.
toBuilder()CellImageBuilderהוא יוצר כלי שהופך תמונה לסוג ערך של תמונה, כדי שתוכלו להציב אותה בתא.

תיעוד מפורט

build()

יוצרת את סוג הערך של התמונה הדרוש להוספת תמונה לתא. ערך התמונה נוצר על סמך מאפייני התמונה שמוסיפים לכלי הבנייה, כמו כתובת ה-URL של המקור.

החזרות

CellImage - ייצוג של התמונה שצריך להוסיף לתא.


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 - כתובת ה-URL של התמונה באירוח Google.


getUrl()

הפונקציה מחזירה את כתובת ה-URL של התמונה המקורית, ומחזירה את הערך null אם כתובת ה-URL לא זמינה. אם התמונה נוספה על ידי כתובת URL באמצעות API, השיטה הזו מחזירה את כתובת ה-URL שצוינה במהלך הוספת התמונה.

החזרות

String – כתובת ה-URL של התמונה, אם היא זמינה. הפונקציה מחזירה את הערך null אם התמונה לא זמינה או שאין לה כתובת URL של מקור.

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

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

setAltTextDescription(description)

מגדיר את תיאור הטקסט החלופי לתמונה הזו.

פרמטרים

שםתיאורהתיאור
descriptionStringהתיאור החדש של הטקסט החלופי לתמונה.

החזרות

CellImage - התמונה הזו, לשרשור.

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

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

setAltTextTitle(title)

מגדיר את כותרת הטקסט החלופי לתמונה הזו.

פרמטרים

שםתיאורהתיאור
titleStringהכותרת החדשה של הטקסט החלופי לתמונה.

החזרות

CellImage - התמונה הזו, לשרשור.

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

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

setSourceUrl(url)

מגדיר את כתובת ה-URL של מקור התמונה.

פרמטרים

שםתיאורהתיאור
urlStringכתובת ה-URL של התמונה.

החזרות

CellImageBuilder – הכלי הזה – לשרשורים.


toBuilder()

הוא יוצר כלי שהופך תמונה לסוג ערך של תמונה, כדי שתוכלו להציב אותה בתא. כדי להוסיף תמונה לתא, צריך ליצור אותה בתור סוג של ערך תמונה. לאחר מכן אפשר להוסיף אותו לתא באמצעות הפונקציה Range.setValue(value) או Range.setValues(values).

החזרות

CellImageBuilder – כלי ליצירת סוג של ערך לתמונה על סמך מאפיינים נתונים של תמונה.