CardService cung cấp khả năng tạo thẻ chung dùng trên nhiều sản phẩm mở rộng của Google, chẳng hạn như Tiện ích bổ sung của Google Workspace.
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ả |
---|---|---|
BorderType | BorderType | Liệt kê BorderType . |
ChipListLayout | ChipListLayout | Liệt kê ChipListLayout . |
ComposedEmailType | ComposedEmailType | Liệt kê ComposedEmailType . |
ContentType | ContentType | Liệt kê ContentType . |
GridItemLayout | GridItemLayout | Liệt kê GridItemLayout . |
HorizontalAlignment | HorizontalAlignment | Liệt kê HorizontalAlignment . |
Icon | Icon | Liệt kê Icon . |
ImageButtonStyle | ImageButtonStyle | Liệt kê ImageButtonStyle . |
ImageCropType | ImageCropType | Liệt kê ImageCropType . |
ImageStyle | ImageStyle | Liệt kê ImageStyle . |
InputType | InputType | Liệt kê InputType . |
LoadIndicator | LoadIndicator | Liệt kê LoadIndicator . |
OnClose | OnClose | Liệt kê OnClose . |
OpenAs | OpenAs | Liệt kê OpenAs . |
SelectionInputType | SelectionInputType | Liệt kê SelectionInputType . |
TextButtonStyle | TextButtonStyle | Liệt kê TextButtonStyle . |
UpdateDraftBodyType | UpdateDraftBodyType | Liệt kê UpdateDraftBodyType . |
Phương thức
Tài liệu chi tiết
newActionResponseBuilder()
Tạo ActionResponseBuilder
mới.
Cầu thủ trả bóng
ActionResponseBuilder
– Trình tạo ActionResponse trống.
newActionStatus()
Tạo một ActionStatus
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
ActionStatus
– Một ActionStatus trống.
newAttachment()
newAuthorizationAction()
newAuthorizationException()
Tạo AuthorizationException
mới.
Cầu thủ trả bóng
AuthorizationException
– Một AuthorizationException trống.
newBorderStyle()
newCalendarEventActionResponseBuilder()
Tạo CalendarEventActionResponseBuilder
mới.
Cầu thủ trả bóng
CalendarEventActionResponseBuilder
– CalendarEventActionResponseBuilder
trống.
newCardAction()
newCardBuilder()
newCardHeader()
newCardSection()
newCardWithId()
Tạo CardWithId
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
CardWithId
– CardWithId
trống.
newChatActionResponse()
Tạo ChatActionResponse
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
ChatActionResponse
– ChatActionResponse
trống.
newChatResponseBuilder()
Tạo ChatResponseBuilder
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
ChatResponseBuilder
– Một ChatResponseBuilder trống.
newChip()
newChipList()
Tạo một ChipList
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 chip = CardService.newChip(); // Finish building the text chip... const chipList = CardService.newChipList() .setLayout(CardService.ChipListLayout.WRAPPED) .addChip(chip);
Cầu thủ trả bóng
ChipList
– Một ChipList trống.
newCollapseControl()
Tạo CollapseControl
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 collapseControl = CardService.newCollapseControl() .setHorizontalAlign(CardService.HorizontalAlignment.START) .setExpandButton(CardService.newTextButton().setText('Expand')) .setCollapseButton(CardService.newTextButton().setText('Collapse'));
Cầu thủ trả bóng
CollapseControl
– 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 một ComposeActionResponseBuilder
mới.
Cầu thủ trả bóng
ComposeActionResponseBuilder
– 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 một DialogAction
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
DialogAction
– DialogAction
trống.
newDivider()
Tạo 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.
newDriveItemsSelectedActionResponseBuilder()
Tạo DriveItemsSelectedActionResponseBuilder
mới.
Cầu thủ trả bóng
DriveItemsSelectedActionResponseBuilder
– DriveItemsSelectedActionResponseBuilder
trống.
newEditorFileScopeActionResponseBuilder()
Tạo một EditorFileScopeActionResponseBuilder
mới.
Cầu thủ trả bóng
EditorFileScopeActionResponseBuilder
– EditorFileScopeActionResponseBuilder
trống.
newImageButton()
newImageComponent()
newImageCropStyle()
newLinkPreview()
Tạo LinkPreview
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
LinkPreview
– Một LinkPreview trống.
newMaterialIcon()
Tạo MaterialIcon
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
MaterialIcon
– Một MaterialIcon trống.
newNotification()
newOverflowMenu()
Tạo OverflowMenu
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 overflowMenuItem = CardService.newOverflowMenuItem(); // Finish building the overflow menu item... const overflowMenu = CardService.newOverflowMenu().addMenuItem(overflowMenuItem);
Cầu thủ trả bóng
OverflowMenu
– Một OverflowMenu trống.
newOverflowMenuItem()
Tạo OverflowMenuItem
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 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
OverflowMenuItem
– Một OverflowMenuItem trống.
newSelectionInput()
newSuggestions()
newSuggestionsResponseBuilder()
Tạo SuggestionsResponseBuilder
mới.
Cầu thủ trả bóng
SuggestionsResponseBuilder
– Một trình tạo SuggestionsResponse trống.
newTextButton()
newTextParagraph()
newTimePicker()
newUniversalActionResponseBuilder()
Tạo một UniversalActionResponseBuilder
mới.
Cầu thủ trả bóng
UniversalActionResponseBuilder
– Trình tạo UniversalActionResponse trống.
newUpdateDraftActionResponseBuilder()
Tạo một UpdateDraftActionResponseBuilder
mới.
Cầu thủ trả bóng
UpdateDraftActionResponseBuilder
– Một UpdateDraftActionResponseBuilder trống.
newUpdateDraftBccRecipientsAction()
Tạo một UpdateDraftBccRecipientsAction
mới;
Cầu thủ trả bóng
UpdateDraftBccRecipientsAction
– Một UpdateDraftBccRecipientsAction trống.
newUpdateDraftBodyAction()
Tạo UpdateDraftBodyAction
mới.
Cầu thủ trả bóng
UpdateDraftBodyAction
– Một UpdateDraftBodyAction trống.
newUpdateDraftCcRecipientsAction()
Tạo một UpdateDraftCcRecipientsAction
mới.
Cầu thủ trả bóng
UpdateDraftCcRecipientsAction
– Một UpdateDraftCcRecipientsAction trống.
newUpdateDraftSubjectAction()
Tạo một UpdateDraftSubjectAction
mới.
Cầu thủ trả bóng
UpdateDraftSubjectAction
– Một UpdateDraftSubjectAction trống.
newUpdateDraftToRecipientsAction()
Tạo UpdateDraftToRecipientsAction
mới.
Cầu thủ trả bóng
UpdateDraftToRecipientsAction
– 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.