Class Image

Image

ווידג'ט שמציג תמונה אחת. מידע על חיתוך תמונות זמין כאן: ImageCropStyle.

ההגדרה זמינה לתוספים ל-Google Workspace ולאפליקציות של Google Chat.

var image = CardService.newImage().setAltText("A nice image").setImageUrl("https://image.png");

שיטות

שיטהסוג הערך המוחזרתיאור קצר
setAltText(altText)Imageהגדרת הטקסט החלופי של התמונה לנגישות.
setAuthorizationAction(action)Imageהגדרה של פעולת הרשאה שפותחת כתובת URL לתהליך ההרשאה כשהאובייקט בוצעה לחיצה.
setComposeAction(action, composedEmailType)Imageמגדיר פעולה שכותבת טיוטת אימייל כשמשתמש לוחץ על האובייקט.
setImageUrl(url)Imageמגדיר את התמונה לשימוש על ידי ציון כתובת ה-URL או מחרוזת הנתונים שלה.
setOnClickAction(action)Imageמגדיר פעולה שמופעלת כשמשתמש לוחץ על האובייקט.
setOnClickOpenLinkAction(action)Imageמגדירה פעולה שפותחת כתובת URL בכרטיסייה כשלוחצים על האובייקט.
setOpenLink(openLink)Imageהגדרת כתובת URL שתיפתח כשלוחצים על האובייקט.

מסמכי תיעוד מפורטים

setAltText(altText)

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

פרמטרים

שםסוגתיאור
altTextStringהטקסט החלופי שצריך להקצות לתמונה.

חזרה

Image – האובייקט הזה, לשרשור.


setAuthorizationAction(action)

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

אובייקט של ממשק משתמש יכול לכלול רק אחת מהאפשרויות הבאות: setOpenLink(openLink), setOnClickAction(action), setOnClickOpenLinkAction(action), setAuthorizationAction(action) או setComposeAction(action, composedEmailType).

// ...

var action = CardService.newAuthorizationAction().setAuthorizationUrl('url');
CardService.newTextButton().setText('Authorize').setAuthorizationAction(action);

פרמטרים

שםסוגתיאור
actionAuthorizationActionהאובייקט שמציין את פעולת ההרשאה לבצע כאשר הרכיב הזה בוצעה לחיצה.

חזרה

Image – האובייקט הזה, לשרשור.


setComposeAction(action, composedEmailType)

מגדיר פעולה שכותבת טיוטת אימייל כשמשתמש לוחץ על האובייקט. אובייקט של ממשק משתמש יכול רק הם אחד מהערכים setOpenLink(openLink), setOnClickAction(action), setOnClickOpenLinkAction(action), setAuthorizationAction(action) או setComposeAction(action, composedEmailType) הוגדרו.

הפרמטר Action חייב לציין פונקציית קריאה חוזרת שמחזירה אובייקט ComposeActionResponse שהוגדר באמצעות ComposeActionResponseBuilder.setGmailDraft(draft).

// ...

var action = CardService.newAction().setFunctionName('composeEmailCallback');
CardService.newTextButton()
    .setText('Compose Email')
    .setComposeAction(action, CardService.ComposedEmailType.REPLY_AS_DRAFT);

// ...

function composeEmailCallback() {
  var thread = GmailApp.getThreadById(e.threadId);
  var draft = thread.createDraftReply('This is a reply');
  return CardService.newComposeActionResponseBuilder()
      .setGmailDraft(draft)
      .build();
}

פרמטרים

שםסוגתיאור
actionActionהאובייקט שמציין את פעולת ההרכבה שצריך לבצע כאשר הרכיב הזה בוצעה לחיצה.
composedEmailTypeComposedEmailTypeערך enum שמציין אם הטיוטה שהורכבה היא בנפרד או כטיוטה של תשובה.

חזרה

Image – האובייקט הזה, לשרשור.


setImageUrl(url)

מגדיר את התמונה לשימוש על ידי ציון כתובת ה-URL או מחרוזת הנתונים שלה. חובה.

כתובת ה-URL יכולה להיות כתובת URL נגישה לציבור או מחרוזת תמונה בקידוד base64. כדי להשיג את המזהה השני, אפשר להשתמש בקוד הבא כדי ליצור מחרוזת תמונה מקודדת את התמונה ב-Google Drive, ואז יש לאחסן את המחרוזת הזו לשימוש מאוחר יותר עם setImageUrl(url). השיטה הזו מונעת את הצורך של התוסף לגשת לקובץ ציבורי כתובת URL של תמונה זמינה:

// The following assumes you have the image to use in Google Drive and have its ID.
var imageBytes = DriveApp.getFileById(imageID).getBlob().getBytes();
var encodedImageURL = "data:image/jpeg;base64," + Utilities.base64Encode(imageBytes);

// You can store encodeImageURL and use it as a parameter to Image.setImageUrl(url).

פרמטרים

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

חזרה

Image – האובייקט הזה, לשרשור.


setOnClickAction(action)

מגדיר פעולה שמופעלת כשמשתמש לוחץ על האובייקט. אובייקט בממשק המשתמש יכול לכלול רק setOpenLink(openLink), setOnClickAction(action), setOnClickOpenLinkAction(action), setAuthorizationAction(action) או setComposeAction(action, composedEmailType) הוגדרו.

הפרמטר Action חייב לציין פונקציית קריאה חוזרת שמחזירה אובייקט ActionResponse.

// ...

var action = CardService.newAction().setFunctionName('notificationCallback');
CardService.newTextButton().setText('Create notification').setOnClickAction(action);

// ...

function notificationCallback() {
  return CardService.newActionResponseBuilder()
      .setNotification(CardService.newNotification()
          .setText("Some info to display to user"))
      .build();
}

פרמטרים

שםסוגתיאור
actionActionהפעולה לביצוע כשלוחצים על הרכיב הזה.

חזרה

Image – האובייקט הזה, לשרשור.


setOnClickOpenLinkAction(action)

מגדירה פעולה שפותחת כתובת URL בכרטיסייה כשלוחצים על האובייקט. צריך להשתמש בפונקציה הזו כאשר צריך ליצור כתובת URL או לבצע פעולות אחרות בנוסף ליצירת האובייקט OpenLink. אובייקט של ממשק משתמש יכול להכיל רק אחד מהערכים setOpenLink(openLink), setOnClickAction(action), setOnClickOpenLinkAction(action), setAuthorizationAction(action) או setComposeAction(action, composedEmailType) הוגדר.

הפרמטר Action חייב לציין פונקציית קריאה חוזרת שמחזירה אובייקט ActionResponse שהוגדר באמצעות ActionResponseBuilder.setOpenLink(openLink).

// ...

var action = CardService.newAction().setFunctionName('openLinkCallback');
CardService.newTextButton().setText('Open Link').setOnClickOpenLinkAction(action);

// ...

function openLinkCallback() {
  return CardService.newActionResponseBuilder()
      .setOpenLink(CardService.newOpenLink()
          .setUrl('https://www.google.com'))
      .build();
}

פרמטרים

שםסוגתיאור
actionActionהאובייקט שמציין את פעולת הקישור הפתוח שיש לבצע כשהרכיב הזה בוצעה לחיצה.

חזרה

Image – האובייקט הזה, לשרשור.


הגדרת כתובת URL שתיפתח כשלוחצים על האובייקט. יש להשתמש בפונקציה הזו כאשר כתובת ה-URL כבר ידוע ורק צריך לפתוח אותו. אובייקט בממשק המשתמש יכול להכיל רק אחד מהערכים setOpenLink(openLink), setOnClickAction(action), setOnClickOpenLinkAction(action), setAuthorizationAction(action), או setComposeAction(action, composedEmailType) מוגדרות.

פרמטרים

שםסוגתיאור
openLinkOpenLinkאובייקט OpenLink שמתאר את כתובת ה-URL שצריך לפתוח.

חזרה

Image – האובייקט הזה, לשרשור.