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
newActionResponseBuilder()
Tạo Action
mới.
Cầu thủ trả bóng
Action
– Trình tạo ActionResponse trống.
newActionStatus()
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.
newAttachment()
newAuthorizationAction()
newAuthorizationException()
Tạo Authorization
mới.
Cầu thủ trả bóng
Authorization
– Một AuthorizationException trống.
newBorderStyle()
newCalendarEventActionResponseBuilder()
Tạo Calendar
mới.
Cầu thủ trả bóng
Calendar
– Calendar
trống.
newCardAction()
newCardBuilder()
newCardHeader()
newCardSection()
newCardWithId()
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.
newCarousel()
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.
newCarouselCard()
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.
newChatActionResponse()
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.
newChatResponseBuilder()
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.
newChip()
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.
newChipList()
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.
newCollapseControl()
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.
newColumn()
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.
newColumns()
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.
newComposeActionResponseBuilder()
Tạo Compose
mới.
Cầu thủ trả bóng
Compose
– Một trình tạo ComposeActionResponse trống.
newDatePicker()
newDateTimePicker()
newDecoratedText()
newDialog()
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
newDialogAction()
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.
newDivider()
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.
newDriveItemsSelectedActionResponseBuilder()
Tạo Drive
mới.
Cầu thủ trả bóng
Drive
– Drive
trống.
newEditorFileScopeActionResponseBuilder()
Tạo Editor
mới.
Cầu thủ trả bóng
Editor
– Editor
trống.
newImageButton()
newImageComponent()
newImageCropStyle()
newLinkPreview()
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.
newMaterialIcon()
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.
newNotification()
newOverflowMenu()
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.
newOverflowMenuItem()
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.
newSelectionInput()
newSuggestions()
newSuggestionsResponseBuilder()
Tạo Suggestions
mới.
Cầu thủ trả bóng
Suggestions
– Một trình tạo SuggestionsResponse trống.
newTextButton()
newTextParagraph()
newTimePicker()
newUniversalActionResponseBuilder()
Tạo Universal
mới.
Cầu thủ trả bóng
Universal
– Trình tạo UniversalActionResponse trống.
newUpdateDraftActionResponseBuilder()
Tạo Update
mới.
Cầu thủ trả bóng
Update
– Một UpdateDraftActionResponseBuilder trống.
newUpdateDraftBccRecipientsAction()
Tạo một Update
mới;
Cầu thủ trả bóng
Update
– Một UpdateDraftBccRecipientsAction trống.
newUpdateDraftBodyAction()
Tạo Update
mới.
Cầu thủ trả bóng
Update
– Một UpdateDraftBodyAction trống.
newUpdateDraftCcRecipientsAction()
Tạo Update
mới.
Cầu thủ trả bóng
Update
– Một UpdateDraftCcRecipientsAction trống.
newUpdateDraftSubjectAction()
Tạo Update
mới.
Cầu thủ trả bóng
Update
– Một UpdateDraftSubjectAction trống.
newUpdateDraftToRecipientsAction()
Tạo Update
mới.
Cầu thủ trả bóng
Update
– Một UpdateDraftToRecipientsAction trống.
newValidation()
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.