Card
בהמשך מופיעה דוגמה לכרטיס של חבילות שירות.
function createCard() { return CardService.newCardBuilder() .setHeader(CardService.newCardHeader().setTitle('CardTitle')) .build(); }
לחלופין, אפשר להחזיר כמה כרטיסים כך:
function createCards() { return [ CardService.newCardBuilder().build(), CardService.newCardBuilder().build(), CardService.newCardBuilder().build(), ]; }
הדוגמה הבאה מראה איך אפשר להגדיר כרטיס עם כותרת, טקסט, תמונה ופריט תפריט:
function createWidgetDemoCard() { return CardService.newCardBuilder() .setHeader( CardService.newCardHeader() .setTitle('Widget demonstration') .setSubtitle('Check out these widgets') .setImageStyle(CardService.ImageStyle.SQUARE) .setImageUrl('https://www.example.com/images/headerImage.png'), ) .addSection( CardService.newCardSection() .setHeader('Simple widgets') // optional .addWidget( CardService.newTextParagraph().setText( 'These widgets are display-only. ' + 'A text paragraph can have multiple lines and ' + 'formatting.', ), ) .addWidget( CardService.newImage().setImageUrl( 'https://www.example.com/images/mapsImage.png', ), ), ) .addCardAction( CardService.newCardAction().setText('Gmail').setOpenLink( CardService.newOpenLink().setUrl('https://mail.google.com/mail'), ), ) .build(); }
דוגמה לכרטיס של אפליקציות ל-Chat.
const cardHeader = CardService.newCardHeader() .setTitle('Sasha') .setSubtitle('Software Engineer') .setImageUrl( 'https://developers.google.com/chat/images/quickstart-app-avatar.png', ) .setImageStyle(CardService.ImageStyle.CIRCLE) .setImageAltText('Avatar for Sasha'); const cardSection = CardService.newCardSection() .setHeader('Contact Info') .setCollapsible(true) .setNumUncollapsibleWidgets(1) .addWidget( CardService.newDecoratedText() .setStartIcon( CardService.newIconImage().setIcon(CardService.Icon.EMAIL)) .setText('sasha@example.com'), ) .addWidget( CardService.newDecoratedText() .setStartIcon( CardService.newIconImage().setIcon(CardService.Icon.PERSON)) .setText('<font color="#80e27e">Online</font>'), ) .addWidget( CardService.newDecoratedText() .setStartIcon( CardService.newIconImage().setIcon(CardService.Icon.PHONE)) .setText('+1 (555) 555-1234'), ) .addWidget( CardService.newButtonSet() .addButton( CardService.newTextButton().setText('Share').setOpenLink( CardService.newOpenLink().setUrl( 'https://example.com/share'), ), ) .addButton( CardService.newTextButton() .setText('Edit') .setOnClickAction( CardService.newAction() .setFunctionName('goToView') .setParameters({viewType: 'EDIT'}), ), ), ); const card = CardService.newCardBuilder() .setHeader(cardHeader) .addSection(cardSection) .build();
מאפיינים
נכס | סוג | תיאור |
---|---|---|
Border | Border | המניין Border . |
Chip | Chip | המניין Chip . |
Composed | Composed | המניין Composed . |
Content | Content | המניין Content . |
Grid | Grid | המניין Grid . |
Horizontal | Horizontal | המניין Horizontal . |
Icon | Icon | המניין Icon . |
Image | Image | המניין Image . |
Image | Image | המניין Image . |
Image | Image | המניין Image . |
Input | Input | המניין Input . |
Load | Load | המניין Load . |
On | On | המניין On . |
Open | Open | המניין Open . |
Selection | Selection | המניין Selection . |
Text | Text | המניין Text . |
Update | Update | המניין Update . |
Methods
מסמכים מפורטים
new Action Response Builder()
new Action Status()
יצירת Action
חדש.
התכונה הזו זמינה רק באפליקציות של Google Chat. לא זמין לתוספים של Google Workspace.
const actionStatus = CardService.newActionStatus() .setStatusCode(CardService.Status.OK) .setUserFacingMessage('Success');
חזרה
Action
– סטטוס פעולה ריק.
new Attachment()
new Authorization Action()
new Authorization Exception()
new Border Style()
new Calendar Event Action Response Builder()
new Card Action()
new Card Builder()
new Card Header()
new Card Section()
new Card With Id()
יצירת Card
חדש. השדה הזה משמש לשליחת כרטיס בהודעה ב-Google Chat. מזהה הכרטיס הוא מזהה ייחודי של כרטיס בהודעה כששולחים כמה כרטיסים.
התכונה הזו זמינה רק באפליקציות של Google Chat. לא זמין לתוספים של Google Workspace.
const cardSection = CardService.newCardSection(); cardSection.addWidget( CardService.newTextParagraph().setText('This is a text paragraph widget.'), ); const card = CardService.newCardBuilder() .setHeader(CardService.newCardHeader().setTitle('Card title')) .addSection(cardSection) .build(); const cardWithId = CardService.newCardWithId().setCardId('card_id').setCard(card);
חזרה
Card
— Card
ריק.
new Chat Action Response()
יצירת Chat
חדש.
התכונה הזו זמינה רק באפליקציות של Google Chat. לא זמין לתוספים של Google Workspace.
const card = CardService.newCardBuilder() .setHeader(CardService.newCardHeader().setTitle('Card title')) .build(); const dialog = CardService.newDialog().setBody(card); const dialogAction = CardService.newDialogAction().setDialog(dialog); const chatActionResponse = CardService.newChatActionResponse() .setResponseType(CardService.ResponseType.DIALOG) .setDialogAction(dialogAction);
חזרה
new Chat Response Builder()
יצירת Chat
חדש.
התכונה הזו זמינה רק באפליקציות של Google Chat. לא זמין לתוספים של Google Workspace.
const cardSection = CardService.newCardSection(); cardSection.addWidget( CardService.newTextParagraph().setText('This is a text paragraph widget.'), ); const card = CardService.newCardBuilder() .setHeader(CardService.newCardHeader().setTitle('Card title')) .addSection(cardSection) .build(); const cardWithId = CardService.newCardWithId().setCardId('card_id').setCard(card); const chatResponse = CardService.newChatResponseBuilder().addCardsV2(cardWithId).build();
חזרה
Chat
— אובייקט ChatResponseBuilder ריק.
new Chip()
new Chip List()
יצירת Chip
חדש.
זמין באפליקציות של Google Chat. בתצוגה המקדימה למפתחים של תוספים ל-Google Workspace.
const chip = CardService.newChip(); // Finish building the text chip... const chipList = CardService.newChipList() .setLayout(CardService.ChipListLayout.WRAPPED) .addChip(chip);
חזרה
Chip
— רשימת צ'יפים ריקה.
new Collapse Control()
יצירת Collapse
חדש.
זמין באפליקציות של Google Chat. בתצוגה המקדימה למפתחים של תוספים ל-Google Workspace.
const collapseControl = CardService.newCollapseControl() .setHorizontalAlign(CardService.HorizontalAlignment.START) .setExpandButton(CardService.newTextButton().setText('Expand')) .setCollapseButton(CardService.newTextButton().setText('Collapse'));
חזרה
Collapse
– CollapseControl ריק.
new Column()
יצירת Column
חדש.
הפיצ'ר זמין באפליקציות של Google Chat ובתוספים של Google Workspace.
const columnWidget = CardService.newTextParagraph(); const column = CardService.newColumn() .setHorizontalSizeStyle( CardService.HorizontalSizeStyle.FILL_AVAILABLE_SPACE) .setHorizontalAlignment(CardService.HorizontalAlignment.CENTER) .setVerticalAlignment(CardService.VerticalAlignment.CENTER) .addWidget(columnWidget);
חזרה
Column
— עמודה ריקה.
new Columns()
יצירת קבוצה חדשה של Columns
.
הפיצ'ר זמין באפליקציות של Google Chat ובתוספים של Google Workspace.
const firstColumn = CardService.newColumn() .setHorizontalSizeStyle( CardService.HorizontalSizeStyle.FILL_AVAILABLE_SPACE) .setHorizontalAlignment(CardService.HorizontalAlignment.CENTER) .setVerticalAlignment(CardService.VerticalAlignment.CENTER); const secondColumn = CardService.newColumn() .setHorizontalSizeStyle( CardService.HorizontalSizeStyle.FILL_AVAILABLE_SPACE) .setHorizontalAlignment(CardService.HorizontalAlignment.CENTER) .setVerticalAlignment(CardService.VerticalAlignment.CENTER); const columns = CardService.newColumns() .addColumn(firstColumn) .addColumn(secondColumn) .setWrapStyle(CardService.WrapStyle.WRAP);
חזרה
Columns
— קבוצה ריקה של עמודות.
new Compose Action Response Builder()
יצירת Compose
חדש.
חזרה
Compose
— ה-builder הריק של ComposeActionResponse.
new Date Picker()
new Date Time Picker()
new Decorated Text()
new Dialog()
יצירת Dialog
חדש.
התכונה הזו זמינה רק באפליקציות של Google Chat. לא זמין לתוספים של Google Workspace.
const card = CardService.newCardBuilder() .setHeader(CardService.newCardHeader().setTitle('Card title')) .build(); // Sets the card of the dialog. const dialog = CardService.newDialog().setBody(card);
חזרה
new Dialog Action()
יצירת Dialog
חדש.
התכונה הזו זמינה רק באפליקציות של Google Chat. לא זמין לתוספים של Google Workspace.
const card = CardService.newCardBuilder() .setHeader(CardService.newCardHeader().setTitle('Card title')) .build(); const dialog = CardService.newDialog().setBody(card); const dialogAction = CardService.newDialogAction().setDialog(dialog);
חזרה
Dialog
— Dialog
ריק.
new Divider()
יצירת Divider
חדש. בדוגמה הבאה נוצר כרטיס פשוט עם 2 פסקאות שמפרידות ביניהן קו מפריד.
function buildCard() { const cardSection1TextParagraph1 = CardService.newTextParagraph().setText('Hello world!'); const cardSection1Divider1 = CardService.newDivider(); const cardSection1TextParagraph2 = CardService.newTextParagraph().setText('Hello world!'); const cardSection1 = CardService.newCardSection() .addWidget(cardSection1TextParagraph1) .addWidget(cardSection1Divider1) .addWidget(cardSection1TextParagraph2); const card = CardService.newCardBuilder().addSection(cardSection1).build(); return card; }
חזרה
Divider
– קו מפריד.
new Drive Items Selected Action Response Builder()
new Editor File Scope Action Response Builder()
new Image Button()
new Image Component()
new Image Crop Style()
new Link Preview()
יצירת Link
חדש.
const decoratedText = CardService.newDecoratedText().setTopLabel('Hello').setText('Hi!'); const cardSection = CardService.newCardSection().addWidget(decoratedText); const card = CardService.newCardBuilder().addSection(cardSection).build(); const linkPreview = CardService.newLinkPreview().setPreviewCard(card).setTitle( 'Smart chip title');
חזרה
Link
— תצוגה מקדימה של קישור ריקה.
new Material Icon()
יצירת Material
חדש.
הפיצ'ר זמין באפליקציות של Google Chat ובתוספים של Google Workspace.
const materialIcon = CardService.newMaterialIcon().setName('check_box').setFill(true); const cardSection = CardService.newCardSection(); cardSection.addWidget( CardService.newDecoratedText() .setStartIcon(CardService.newIconImage().setMaterialIcon(materialIcon)) .setText('sasha@example.com'), ); const card = CardService.newCardBuilder() .setHeader(CardService.newCardHeader().setTitle('Card Title')) .addSection(cardSection) .build();
חזרה
Material
– MaterialIcon ריק.
new Notification()
new Overflow Menu()
יצירת Overflow
חדש.
זמין באפליקציות של Google Chat. בתצוגה המקדימה למפתחים של תוספים ל-Google Workspace.
const overflowMenuItem = CardService.newOverflowMenuItem(); // Finish building the overflow menu item... const overflowMenu = CardService.newOverflowMenu().addMenuItem(overflowMenuItem);
חזרה
Overflow
— תפריט Overflow ריק.
new Overflow Menu Item()
יצירת Overflow
חדש.
זמין באפליקציות של 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'));
חזרה
Overflow
– OverflowMenuItem ריק.
new Selection Input()
new Suggestions()
new Suggestions Response Builder()
יצירת Suggestions
חדש.
חזרה
Suggestions
– יצירת SuggestionsResponse ריק.
new Text Button()
new Text Paragraph()
new Time Picker()
new Universal Action Response Builder()
יצירת Universal
חדש.
חזרה
Universal
– ה-builder הריק של UniversalActionResponse.
new Update Draft Action Response Builder()
יצירת Update
חדש.
חזרה
Update
– אובייקט UpdateDraftActionResponseBuilder ריק.
new Update Draft Bcc Recipients Action()
יצירת Update
חדש.
חזרה
Update
– אירוע UpdateDraftBccRecipientsAction ריק.
new Update Draft Body Action()
new Update Draft Cc Recipients Action()
יצירת Update
חדש.
חזרה
Update
— פעולה ריקה מסוג UpdateDraftCcRecipientsAction.
new Update Draft Subject Action()
יצירת Update
חדש.
חזרה
Update
– אובייקט UpdateDraftSubjectAction ריק.
new Update Draft To Recipients Action()
יצירת Update
חדש.
חזרה
Update
— אובייקט UpdateDraftToRecipientsAction ריק.
new Validation()
יצירת Validation
חדש.
הפיצ'ר זמין באפליקציות של Google Chat ובתוספים של Google Workspace.
const validation = CardService.newValidation().setCharacterLimit(5).setInputType( CardService.InputType.EMAIL);
חזרה
Validation
— אימות ריק.