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 Action mới.
Cầu thủ trả bóng
Action – Trình tạo ActionResponse trống.
new Action Status()
Tạo 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()
new Authorization Exception()
Tạo 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 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 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 Carousel()
Tạo Carousel.
const carousel = CardService.newCarousel() .addCarouselCard(CardService.newCarouselCard().addWidget( CardService.newTextParagraph().setText('The first text paragraph in carousel'))) .addCarouselCard(CardService.newCarouselCard().addWidget( CardService.newTextParagraph().setText('The second text paragraph in carousel'))) .addCarouselCard(CardService.newCarouselCard().addWidget( CardService.newTextParagraph().setText('The third text paragraph in carousel')))
Cầu thủ trả bóng
Carousel – Một băng chuyền trống.
new Carousel Card()
Tạo Carousel mới.
const carouselCard = CardService.newCarouselCard().addWidget( CardService.newTextParagraph().setText('Text paragraph in carousel'));
Cầu thủ trả bóng
Carousel – Khối trống.
new Chat Action Response()
Tạo 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 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 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 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 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 Column mới.
Có sẵn cho các ứ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 các ứ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 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 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 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 Divider mới. Mẫu sau đây tạo một thẻ đơn giản với 2 đoạn vă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 Drive mới.
Cầu thủ trả bóng
Drive – Drive trống.
new Editor File Scope Action Response Builder()
Tạo 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 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 Material mới.
Có sẵn cho các ứ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 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 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 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 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 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 Update mới.
Cầu thủ trả bóng
Update – Một UpdateDraftBodyAction trống.
new Update Draft Cc Recipients Action()
Tạo Update mới.
Cầu thủ trả bóng
Update – Một UpdateDraftCcRecipientsAction trống.
new Update Draft Subject Action()
Tạo Update mới.
Cầu thủ trả bóng
Update – Một UpdateDraftSubjectAction trống.
new Update Draft To Recipients Action()
Tạo Update mới.
Cầu thủ trả bóng
Update – Một UpdateDraftToRecipientsAction trống.
new Validation()
Tạo Validation mới.
Có sẵn cho các ứ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.