Class Chip

צ'יפ

Chip עם סמל ותווית טקסט. אפשר להשבית את הצ'יפ כשצריך.

זמין באפליקציות שפועלות עם Google Chat. בתצוגה מקדימה למפתחים של תוספים ל-Google Workspace.

const chip = CardService.newChip()
                 .setLabel('Open Link')
                 .setOpenLink(CardService.newOpenLink().setUrl(
                     'https://www.google.com'));

Methods

שיטהסוג הערך שמוחזרתיאור קצר
setAltText(altText)Chipההגדרה הזו קובעת את הטקסט החלופי של הצ'יפ לצורכי נגישות.
setAuthorizationAction(action)Chipהגדרה של פעולת הרשאה שפותחת כתובת URL לתהליך ההרשאה כשלוחצים על האובייקט.
setComposeAction(action, composedEmailType)Chipהגדרת פעולה שיוצרת טיוטת אימייל כשלוחצים על האובייקט.
setDisabled(disabled)Chipההגדרה קובעת אם הצ'יפ מושבת.
setIcon(icon)Chipמגדירה את הסמל שיוצג כצ'יפ.
setLabel(label)Chipמגדיר את שם הצ'יפ.
setOnClickAction(action)Chipהגדרת פעולה שמתבצעת כשלוחצים על האובייקט.
setOnClickOpenLinkAction(action)Chipהגדרת פעולה שפותחת כתובת URL בכרטיסייה כשלוחצים על האובייקט.
setOpenLink(openLink)Chipהגדרה של כתובת URL שתיפתח כשלוחצים על האובייקט.

תיעוד מפורט

setAltText(altText)

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

פרמטרים

שםסוגתיאור
altTextStringהטקסט החלופי שיוקצה לצ'יפ הזה.

חזרה

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


setAuthorizationAction(action)

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

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

// ...

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

פרמטרים

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

חזרה

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


setComposeAction(action, composedEmailType)

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

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

// ...

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

// ...

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

פרמטרים

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

חזרה

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


setDisabled(disabled)

ההגדרה קובעת אם הצ'יפ מושבת. צ'יפ מושבת מופיע באפור ואי אפשר ללחוץ עליו.

const chip = CardService.newChip().setLabel('bug Report').setDisabled(true);

פרמטרים

שםסוגתיאור
disabledBooleanהמצב המושבת.

חזרה

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


setIcon(icon)

מגדירה את הסמל שיוצג כצ'יפ.

const chip = CardService.newChip().setIcon(
    CardService.newIconImage().setMaterialIcon(
        CardService.newMaterialIcon().setName('bug_report'),
        ),
);

פרמטרים

שםסוגתיאור
iconIconImageאחד מהערכים המוגדרים מראש של IconImage.

חזרה

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


setLabel(label)

מגדיר את שם הצ'יפ. חובה.

const chip = CardService.newChip().setLabel('bug Report');

פרמטרים

שםסוגתיאור
labelStringהטקסט שיוצג.

חזרה

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


setOnClickAction(action)

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

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

// ...

const 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הפעולה שתתבצע כשלוחצים על האלמנט הזה.

חזרה

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


setOnClickOpenLinkAction(action)

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

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

// ...

const 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האובייקט שמציין את פעולת פתיחת הקישור שתתבצע כשלוחצים על הרכיב הזה.

חזרה

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


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

פרמטרים

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

חזרה

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