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ả lại 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 | Bản liệt kê ChipListLayout . |
ComposedEmailType | ComposedEmailType | Liệt kê ComposedEmailType . |
ContentType | ContentType | Liệt kê ContentType . |
GridItemLayout | GridItemLayout | Bản liệt kê GridItemLayout . |
HorizontalAlignment | HorizontalAlignment | Bản liệt kê HorizontalAlignment . |
Icon | Icon | Liệt kê Icon . |
ImageButtonStyle | ImageButtonStyle | Liệt kê ImageButtonStyle . |
ImageCropType | ImageCropType | Liệt kê ImageCropType . |
ImageStyle | ImageStyle | Bản liệt kê ImageStyle . |
InputType | InputType | Liệt kê InputType . |
LoadIndicator | LoadIndicator | Bản liệt kê LoadIndicator . |
OnClose | OnClose | Liệt kê OnClose . |
OpenAs | OpenAs | Bản liệt kê OpenAs . |
SelectionInputType | SelectionInputType | Liệt kê SelectionInputType . |
TextButtonStyle | TextButtonStyle | Bản 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 ActionStatus
mới.
Chỉ dùng được 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 một 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ùng được 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ùng được 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 ChipList
mới.
Chỉ dùng được 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 một 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 ứ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 ứ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(column) .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 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 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 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 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 một 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 một MaterialIcon
mới.
Dùng được cho các ứng dụng trong 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ùng được 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
— Trình tạo hàm đề xuất phản hồi trống.
newTextButton()
newTextParagraph()
newTimePicker()
newUniversalActionResponseBuilder()
Tạo 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 UpdateReleaseActionResponseBuilder trống.
newUpdateDraftBccRecipientsAction()
Tạo một UpdateDraftBccRecipientsAction
mới;
Cầu thủ trả bóng
UpdateDraftBccRecipientsAction
— Một Cập nhật bccnhccccsAction trống.
newUpdateDraftBodyAction()
Tạo một UpdateDraftBodyAction
mới.
Cầu thủ trả bóng
UpdateDraftBodyAction
— Một Update DraftBodyAction 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 UpdateDraftSubjectAction
mới.
Cầu thủ trả bóng
UpdateDraftSubjectAction
– Một UpdateDraftSubjectAction trống.
newUpdateDraftToRecipientsAction()
Tạo một 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 ứ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.