OverflowMenuItem עם סמל ותווית טקסט. אפשר להשבית את פריט התפריט כשצריך.
זמין באפליקציות שפועלות עם Google Chat. בתצוגה מקדימה למפתחים של תוספים ל-Google Workspace.
const overflowMenuItem = CardService.newOverflowMenuItem() .setStartIcon( CardService.newIconImage().setIconUrl( 'https://www.google.com/images/branding/googleg/1x/googleg_standard_color_64dp.png', ), ) .setText('Open Link') .setOpenLink( CardService.newOpenLink().setUrl('https://www.google.com'));
Methods
| שיטה | סוג הערך שמוחזר | תיאור קצר |
|---|---|---|
set | Overflow | הגדרה של פעולת הרשאה שפותחת כתובת URL לתהליך ההרשאה כשלוחצים על האובייקט. |
set | Overflow | הגדרת פעולה שיוצרת טיוטת אימייל כשלוחצים על האובייקט. |
set | Overflow | הגדרה של האם האפשרות בתפריט מושבתת. |
set | Overflow | הגדרת פעולה שמתבצעת כשלוחצים על האובייקט. |
set | Overflow | הגדרת פעולה שפותחת כתובת URL בכרטיסייה כשלוחצים על האובייקט. |
set | Overflow | הגדרה של כתובת URL שתיפתח כשלוחצים על האובייקט. |
set | Overflow | מגדירה את הסמל המוביל של פריט התפריט. |
set | Overflow | הגדרת הכותרת של אפשרות בתפריט. |
תיעוד מפורט
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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
action | Authorization | האובייקט שמציין את פעולת ההרשאה שתתבצע כשלוחצים על הרכיב הזה. |
חזרה
OverflowMenuItem – האובייקט הזה, לשרשור.
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(); }
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
action | Action | האובייקט שמציין את פעולת ההודעה שצריך לבצע כשלוחצים על הרכיב הזה. |
composed | Composed | ערך enum שמציין אם הטיוטה המורכבת היא טיוטה עצמאית או טיוטה של תשובה. |
חזרה
OverflowMenuItem – האובייקט הזה, לשרשור.
setDisabled(disabled)
הגדרה של האם האפשרות בתפריט מושבתת. פריט מושבת מוצג באפור ואי אפשר ללחוץ עליו.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
disabled | Boolean | המצב המושבת. |
חזרה
OverflowMenuItem – האובייקט הזה, לשרשור.
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(); }
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
action | Action | הפעולה שתתבצע כשלוחצים על האלמנט הזה. |
חזרה
OverflowMenuItem – האובייקט הזה, לשרשור.
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(); }
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
action | Action | האובייקט שמציין את פעולת פתיחת הקישור שתתבצע כשלוחצים על הרכיב הזה. |
חזרה
OverflowMenuItem – האובייקט הזה, לשרשור.
setOpenLink(openLink)
הגדרה של כתובת URL שתיפתח כשלוחצים על האובייקט. משתמשים בפונקציה הזו כשכתובת ה-URL כבר ידועה וצריך רק לפתוח אותה. אפשר להגדיר לאובייקט בממשק המשתמש רק אחת מהאפשרויות הבאות: setOpenLink(openLink), setOnClickAction(action), setOnClickOpenLinkAction(action), setAuthorizationAction(action) או setComposeAction(action, composedEmailType).
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
open | Open | אובייקט Open שמתאר את כתובת ה-URL שצריך לפתוח. |
חזרה
OverflowMenuItem – האובייקט הזה, לשרשור.
setStartIcon(icon)
מגדירה את הסמל המוביל של פריט התפריט.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
icon | Icon | הסמל שיוצג. |
חזרה
OverflowMenuItem – האובייקט הזה, לשרשור.
setText(text)
הגדרת הכותרת של אפשרות בתפריט. חובה.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
text | String | הטקסט שיוצג. |
חזרה
OverflowMenuItem – האובייקט הזה, לשרשור.