Dịch vụ
Dưới đây là mẫu thẻ tiện ích bổ sung.
function createCard() { return CardService.newCardBuilder() .setHeader(CardService.newCardHeader().setTitle('CardTitle')) .build(); }
Hoặc bạn có thể trả về nhiều Thẻ như sau:
function createCards() { return [ CardService.newCardBuilder().build(), CardService.newCardBuilder().build(), CardService.newCardBuilder().build(), ]; }
Phần sau đây cho biết cách bạn có thể xác định một thẻ có tiêu đề, văn bản, hình ảnh và một mục trong trình đơn:
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(); }
Mẫu cho thẻ Ứng dụng trò chuyện.
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();
Thuộc tính
Thuộc tính | Loại | Mô tả |
---|---|---|
Border | Border | Liệt kê Border . |
Chip | Chip | Liệt kê Chip . |
Composed | Composed | Liệt kê Composed . |
Content | Content | Liệt kê Content . |
Grid | Grid | Liệt kê Grid . |
Horizontal | Horizontal | Liệt kê Horizontal . |
Icon | Icon | Liệt kê Icon . |
Image | Image | Liệt kê Image . |
Image | Image | Liệt kê Image . |
Image | Image | Liệt kê Image . |
Input | Input | Liệt kê Input . |
Load | Load | Liệt kê Load . |
On | On | Liệt kê On . |
Open | Open | Liệt kê Open . |
Selection | Selection | Liệt kê Selection . |
Text | Text | Liệt kê Text . |
Update | Update | Liệt kê Update . |
Phương thức
Tài liệu chi tiết
new Action Response Builder()
Tạo một Action
mới.
Cầu thủ trả bóng
Action
– Trình tạo ActionResponse trống.
new Action Status()
Tạo một Action
mới.
Chỉ dành cho ứng dụng Google Chat. Không dùng được cho các tiện ích bổ sung của Google Workspace.
const actionStatus = CardService.newActionStatus() .setStatusCode(CardService.Status.OK) .setUserFacingMessage('Success');
Cầu thủ trả bóng
Action
– Một ActionStatus trống.
new Attachment()
new Authorization Action()
Tạo một Authorization
mới.
Cầu thủ trả bóng
Authorization
– Một AuthorizationAction trống.
new Authorization Exception()
Tạo một Authorization
mới.
Cầu thủ trả bóng
Authorization
– Một AuthorizationException trống.
new Border Style()
new Calendar Event Action Response Builder()
Tạo một Calendar
mới.
Cầu thủ trả bóng
Calendar
– Calendar
trống.
new Card Action()
new Card Builder()
new Card Header()
new Card Section()
new Card With Id()
Tạo một Card
mới. Thuộc tính này dùng để gửi thẻ trong tin nhắn trên Google Chat. Mã thẻ là giá trị nhận dạng duy nhất cho một thẻ trong tin nhắn khi gửi nhiều thẻ.
Chỉ dành cho ứng dụng Google Chat. Không dùng được cho các tiện ích bổ sung của 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);
Cầu thủ trả bóng
Card
– Card
trống.
new Chat Action Response()
Tạo một Chat
mới.
Chỉ dành cho ứng dụng Google Chat. Không dùng được cho các tiện ích bổ sung của 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);
Cầu thủ trả bóng
Chat
– Chat
trống.
new Chat Response Builder()
Tạo một Chat
mới.
Chỉ dành cho ứng dụng Google Chat. Không dùng được cho các tiện ích bổ sung của 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();
Cầu thủ trả bóng
Chat
– Một ChatResponseBuilder trống.
new Chip()
Tạo một Chip
mới.
Có sẵn cho các ứng dụng Google Chat. Trong bản dùng thử dành cho nhà phát triển cho Tiện ích bổ sung của Google Workspace.
const chip = CardService.newChip() .setLabel('Open Link') .setOpenLink(CardService.newOpenLink().setUrl( 'https://www.google.com'));
Cầu thủ trả bóng
Chip
– Khối trống.
new Chip List()
Tạo một Chip
mới.
Có sẵn cho các ứng dụng Google Chat. Trong bản dùng thử dành cho nhà phát triển cho Tiện ích bổ sung của Google Workspace.
const chip = CardService.newChip(); // Finish building the text chip... const chipList = CardService.newChipList() .setLayout(CardService.ChipListLayout.WRAPPED) .addChip(chip);
Cầu thủ trả bóng
Chip
– Một ChipList trống.
new Collapse Control()
Tạo một Collapse
mới.
Có sẵn cho các ứng dụng Google Chat. Trong bản dùng thử dành cho nhà phát triển cho Tiện ích bổ sung của Google Workspace.
const collapseControl = CardService.newCollapseControl() .setHorizontalAlign(CardService.HorizontalAlignment.START) .setExpandButton(CardService.newTextButton().setText('Expand')) .setCollapseButton(CardService.newTextButton().setText('Collapse'));
Cầu thủ trả bóng
Collapse
– Một CollapseControl trống.
new Column()
Tạo một Column
mới.
Có sẵn cho ứng dụng Google Chat và Tiện ích bổ sung của 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);
Cầu thủ trả bóng
Column
– Cột trống.
new Columns()
Tạo một tập hợp Columns
mới.
Có sẵn cho ứng dụng Google Chat và Tiện ích bổ sung của 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);
Cầu thủ trả bóng
Columns
– Một tập hợp Cột trống.
new Compose Action Response Builder()
Tạo một Compose
mới.
Cầu thủ trả bóng
Compose
– Một trình tạo ComposeActionResponse trống.
new Date Picker()
new Date Time Picker()
new Decorated Text()
new Dialog()
Tạo một Dialog
mới.
Chỉ dành cho ứng dụng Google Chat. Không dùng được cho các tiện ích bổ sung của 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);
Cầu thủ trả bóng
new Dialog Action()
Tạo một Dialog
mới.
Chỉ dành cho ứng dụng Google Chat. Không dùng được cho các tiện ích bổ sung của 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);
Cầu thủ trả bóng
Dialog
– Dialog
trống.
new Divider()
Tạo một Divider
mới. Mẫu sau đây tạo một thẻ đơn giản có 2 đoạn văn bản được phân tách bằng một đường phân chia.
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; }
Cầu thủ trả bóng
Divider
– Dòng phân cách.
new Drive Items Selected Action Response Builder()
Tạo một Drive
mới.
Cầu thủ trả bóng
Drive
– Drive
trống.
new Editor File Scope Action Response Builder()
Tạo một Editor
mới.
Cầu thủ trả bóng
Editor
– Editor
trống.
new Image Button()
new Image Component()
new Image Crop Style()
new Link Preview()
Tạo một Link
mới.
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');
Cầu thủ trả bóng
Link
– Một LinkPreview trống.
new Material Icon()
Tạo một Material
mới.
Có sẵn cho ứng dụng Google Chat và Tiện ích bổ sung của 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();
Cầu thủ trả bóng
Material
– Một MaterialIcon trống.
new Notification()
new Overflow Menu()
Tạo một Overflow
mới.
Có sẵn cho các ứng dụng Google Chat. Trong bản dùng thử dành cho nhà phát triển cho Tiện ích bổ sung của Google Workspace.
const overflowMenuItem = CardService.newOverflowMenuItem(); // Finish building the overflow menu item... const overflowMenu = CardService.newOverflowMenu().addMenuItem(overflowMenuItem);
Cầu thủ trả bóng
Overflow
– Một OverflowMenu trống.
new Overflow Menu Item()
Tạo một Overflow
mới.
Có sẵn cho các ứng dụng Google Chat. Trong bản dùng thử dành cho nhà phát triển cho Tiện ích bổ sung của 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'));
Cầu thủ trả bóng
Overflow
– Một OverflowMenuItem trống.
new Selection Input()
new Suggestions()
new Suggestions Response Builder()
Tạo một Suggestions
mới.
Cầu thủ trả bóng
Suggestions
– Một trình tạo SuggestionsResponse trống.
new Text Button()
new Text Paragraph()
new Time Picker()
new Universal Action Response Builder()
Tạo một Universal
mới.
Cầu thủ trả bóng
Universal
– Trình tạo UniversalActionResponse trống.
new Update Draft Action Response Builder()
Tạo một Update
mới.
Cầu thủ trả bóng
Update
– Một UpdateDraftActionResponseBuilder trống.
new Update Draft Bcc Recipients Action()
Tạo một Update
mới;
Cầu thủ trả bóng
Update
– Một UpdateDraftBccRecipientsAction trống.
new Update Draft Body Action()
Tạo một Update
mới.
Cầu thủ trả bóng
Update
– Một UpdateDraftBodyAction trống.
new Update Draft Cc Recipients Action()
Tạo một Update
mới.
Cầu thủ trả bóng
Update
– Một UpdateDraftCcRecipientsAction trống.
new Update Draft Subject Action()
Tạo một Update
mới.
Cầu thủ trả bóng
Update
– Một UpdateDraftSubjectAction trống.
new Update Draft To Recipients Action()
Tạo một Update
mới.
Cầu thủ trả bóng
Update
– Một UpdateDraftToRecipientsAction trống.
new Validation()
Tạo một Validation
mới.
Có sẵn cho ứng dụng Google Chat và Tiện ích bổ sung của Google Workspace.
const validation = CardService.newValidation().setCharacterLimit(5).setInputType( CardService.InputType.EMAIL);
Cầu thủ trả bóng
Validation
– Xác thực trống.