Class CardService

CardService

CardService mang đến khả năng tạo thẻ chung để dùng trên các dịch vụ của Google các sản phẩm có thể mở rộng, chẳng hạn như Tiện ích bổ sung của Google Workspace.

Dưới đây là mẫu cho thẻ tiện ích bổ sung. 

return CardService.newCardBuilder()
         .setHeader(CardService.newCardHeader().setTitle("CardTitle"))
         .build();

Hoặc bạn có thể trả lại nhiều Thẻ như sau: 

return [
  CardService.newCardBuilder().build(),
  CardService.newCardBuilder().build(),
  CardService.newCardBuilder().build()
]

Sau đây là cách xác định 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ẻ Các ứng dụng trong Chat. 

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ínhLoạiMô tả
BorderTypeBorderTypeBản liệt kê BorderType.
ComposedEmailTypeComposedEmailTypeBản liệt kê ComposedEmailType.
ContentTypeContentTypeBản liệt kê ContentType.
GridItemLayoutGridItemLayoutBản liệt kê GridItemLayout.
HorizontalAlignmentHorizontalAlignmentBản liệt kê HorizontalAlignment.
IconIconBản liệt kê Icon.
ImageCropTypeImageCropTypeBản liệt kê ImageCropType.
ImageStyleImageStyleBản liệt kê ImageStyle.
LoadIndicatorLoadIndicatorBản liệt kê LoadIndicator.
OnCloseOnCloseBản liệt kê OnClose.
OpenAsOpenAsBản liệt kê OpenAs.
SelectionInputTypeSelectionInputTypeBản liệt kê SelectionInputType.
TextButtonStyleTextButtonStyleBản liệt kê TextButtonStyle.
UpdateDraftBodyTypeUpdateDraftBodyTypeBản liệt kê UpdateDraftBodyType.

Phương thức

Phương thứcLoại dữ liệu trả vềMô tả ngắn
newAction()ActionTạo một Action mới.
newActionResponseBuilder()ActionResponseBuilderTạo một ActionResponseBuilder mới.
newActionStatus()ActionStatusTạo một ActionStatus mới.
newAttachment()AttachmentTạo một Attachment mới.
newAuthorizationAction()AuthorizationActionTạo một AuthorizationAction mới.
newAuthorizationException()AuthorizationExceptionTạo một AuthorizationException mới.
newBorderStyle()BorderStyleTạo một BorderStyle mới.
newButtonSet()ButtonSetTạo một ButtonSet mới.
newCalendarEventActionResponseBuilder()CalendarEventActionResponseBuilderTạo một CalendarEventActionResponseBuilder mới.
newCardAction()CardActionTạo một CardAction mới.
newCardBuilder()CardBuilderTạo một CardBuilder mới.
newCardHeader()CardHeaderTạo một CardHeader mới.
newCardSection()CardSectionTạo một CardSection mới.
newCardWithId()CardWithIdTạo một CardWithId mới.
newChatActionResponse()ChatActionResponseTạo một ChatActionResponse mới.
newChatResponseBuilder()ChatResponseBuilderTạo một ChatResponseBuilder mới.
newColumn()ColumnTạo một Column mới.
newColumns()ColumnsTạo một tập hợp Columns mới.
newComposeActionResponseBuilder()ComposeActionResponseBuilderTạo một ComposeActionResponseBuilder mới.
newDatePicker()DatePickerTạo một DatePicker mới.
newDateTimePicker()DateTimePickerTạo một DateTimePicker mới.
newDecoratedText()DecoratedTextTạo một DecoratedText mới.
newDialog()DialogTạo một Dialog mới.
newDialogAction()DialogActionTạo một DialogAction mới.
newDivider()DividerTạo một Divider mới.
newDriveItemsSelectedActionResponseBuilder()DriveItemsSelectedActionResponseBuilderTạo một DriveItemsSelectedActionResponseBuilder mới.
newEditorFileScopeActionResponseBuilder()EditorFileScopeActionResponseBuilderTạo một EditorFileScopeActionResponseBuilder mới.
newFixedFooter()FixedFooterTạo một FixedFooter mới.
newGrid()GridTạo một Grid mới.
newGridItem()GridItemTạo một GridItem mới.
newIconImage()IconImageTạo một IconImage mới.
newImage()ImageTạo một Image mới.
newImageButton()ImageButtonTạo một ImageButton mới.
newImageComponent()ImageComponentTạo một ImageComponent mới.
newImageCropStyle()ImageCropStyleTạo một ImageCropStyle mới.
newKeyValue()KeyValueTạo một KeyValue mới.
newLinkPreview()LinkPreviewTạo một LinkPreview mới.
newNavigation()NavigationTạo một Navigation mới.
newNotification()NotificationTạo một Notification mới.
newOpenLink()OpenLinkTạo một OpenLink mới.
newSelectionInput()SelectionInputTạo một SelectionInput mới.
newSuggestions()SuggestionsTạo một Suggestions mới.
newSuggestionsResponseBuilder()SuggestionsResponseBuilderTạo một SuggestionsResponseBuilder mới.
newSwitch()SwitchTạo một Switch mới.
newTextButton()TextButtonTạo một TextButton mới.
newTextInput()TextInputTạo một TextInput mới.
newTextParagraph()TextParagraphTạo một TextParagraph mới.
newTimePicker()TimePickerTạo một TimePicker mới.
newUniversalActionResponseBuilder()UniversalActionResponseBuilderTạo một UniversalActionResponseBuilder mới.
newUpdateDraftActionResponseBuilder()UpdateDraftActionResponseBuilderTạo một UpdateDraftActionResponseBuilder mới.
newUpdateDraftBccRecipientsAction()UpdateDraftBccRecipientsActionTạo một UpdateDraftBccRecipientsAction mới;
newUpdateDraftBodyAction()UpdateDraftBodyActionTạo một UpdateDraftBodyAction mới.
newUpdateDraftCcRecipientsAction()UpdateDraftCcRecipientsActionTạo một UpdateDraftCcRecipientsAction mới.
newUpdateDraftSubjectAction()UpdateDraftSubjectActionTạo một UpdateDraftSubjectAction mới.
newUpdateDraftToRecipientsAction()UpdateDraftToRecipientsActionTạo một UpdateDraftToRecipientsAction mới.
newValidation()ValidationTạo một Validation mới.

Tài liệu chi tiết

newAction()

Tạo một Action mới.

Cầu thủ trả bóng

Action — Một Hành động trống.

newActionResponseBuilder()

Tạo một 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ù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()

Tạo một Attachment mới.

Cầu thủ trả bóng

Attachment — Tệp đính kèm trống.

newAuthorizationAction()

Tạo một AuthorizationAction mới.

Cầu thủ trả bóng

AuthorizationAction — Một AuthorizedAction trống.

newAuthorizationException()

Tạo một AuthorizationException mới.

Cầu thủ trả bóng

AuthorizationException — Uỷ quyền ngoại lệ trống.

newBorderStyle()

Tạo một BorderStyle mới.

Cầu thủ trả bóng

BorderStyle – BorderStyle trống.

newButtonSet()

Tạo một ButtonSet mới.

Cầu thủ trả bóng

ButtonSet — Một ButtonSet trống.

newCalendarEventActionResponseBuilder()

newCardAction()

Tạo một CardAction mới.

Cầu thủ trả bóng

CardAction — Một CardAction trống.

newCardBuilder()

Tạo một CardBuilder mới.

Cầu thủ trả bóng

CardBuilder — Một Trình tạo thẻ trống.

newCardHeader()

Tạo một CardHeader mới.

Cầu thủ trả bóng

CardHeader – Một CardHeader trống.

newCardSection()

Tạo một CardSection mới.

Cầu thủ trả bóng

CardSection — Một mục thẻ trống.

newCardWithId()

Tạo một CardWithId mới. Thông tin 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 thư 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 một ChatActionResponse 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 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 một 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.

newColumn()

Tạo một Column mới.

Dùng được 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);

Column – Một cột trống.

newColumns()

Tạo một tập hợp Columns mới.

Dùng được 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(column)
    .addColumn(secondColumn)
    .setWrapStyle(CardService.WrapStyle.WRAP);

Cầu thủ trả bóng

Columns — Một nhóm 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()

Tạo một DatePicker mới.

Cầu thủ trả bóng

DatePicker — Một DatePicker trống.

newDateTimePicker()

Tạo một DateTimePicker mới.

Cầu thủ trả bóng

DateTimePicker – Một DateTimePicker trống.

newDecoratedText()

Tạo một DecoratedText mới.

Cầu thủ trả bóng

DecoratedText — Một decorationdText trống.

newDialog()

Tạo một Dialog 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 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

Dialog — Dialog trống.

newDialogAction()

Tạo một DialogAction 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 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 một Divider mới. Mẫu sau đây tạo một thẻ đơn giản gồm 2 đoạn văn được phân tách bằng một đường phân cách. 

function buildCard() {
    let cardSection1TextParagraph1 = CardService.newTextParagraph()
        .setText('Hello world!');

    let cardSection1Divider1 = CardService.newDivider();

    let cardSection1TextParagraph2 = CardService.newTextParagraph()
        .setText('Hello world!');

    let cardSection1 = CardService.newCardSection()
        .addWidget(cardSection1TextParagraph1)
        .addWidget(cardSection1Divider1)
        .addWidget(cardSection1TextParagraph2);

    let card = CardService.newCardBuilder()
        .addSection(cardSection1)
        .build();

   return card;
}

Cầu thủ trả bóng

Divider — Một đường phân chia.

newDriveItemsSelectedActionResponseBuilder()

newEditorFileScopeActionResponseBuilder()

newFixedFooter()

Tạo một FixedFooter mới.

Cầu thủ trả bóng

FixedFooter – Một cố định cuối trang trống.

newGrid()

Tạo một Grid mới.

Cầu thủ trả bóng

Grid – Một lưới trống.

newGridItem()

Tạo một GridItem mới.

Cầu thủ trả bóng

GridItem – Một GridItem trống.

newIconImage()

Tạo một IconImage mới.

Cầu thủ trả bóng

IconImage — Một hình ảnh biểu tượng trống.

newImage()

Tạo một Image mới.

Cầu thủ trả bóng

Image — Một hình ảnh trống.

newImageButton()

Tạo một ImageButton mới.

Cầu thủ trả bóng

ImageButton – Một ImageButton trống.

newImageComponent()

Tạo một ImageComponent mới.

Cầu thủ trả bóng

ImageComponent – Một ImageComponent trống.

newImageCropStyle()

Tạo một ImageCropStyle mới.

Cầu thủ trả bóng

ImageCropStyle — Một ImageCutStyle trống.

newKeyValue()

Tạo một KeyValue mới.

Cầu thủ trả bóng

KeyValue – Một giá trị khoá trống.

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.

newNavigation()

Tạo một Navigation mới.

Cầu thủ trả bóng

Navigation — Thành phần Điều hướng trống.

newNotification()

Tạo một Notification mới.

Cầu thủ trả bóng

Notification — Một thông báo trống.

Tạo một OpenLink mới.

Cầu thủ trả bóng

OpenLink — OpenLink trống.

newSelectionInput()

Tạo một SelectionInput mới.

Cầu thủ trả bóng

SelectionInput – Một SelectionInput trống.

newSuggestions()

Tạo một Suggestions mới.

Cầu thủ trả bóng

Suggestions — Đề xuất trống.

newSuggestionsResponseBuilder()

Tạo một SuggestionsResponseBuilder mới.

Cầu thủ trả bóng

SuggestionsResponseBuilder — Trình tạo hàm đề xuất phản hồi trống.

newSwitch()

Tạo một Switch mới.

Cầu thủ trả bóng

Switch — Nút chuyển trống.

newTextButton()

Tạo một TextButton mới.

Cầu thủ trả bóng

TextButton – Một TextButton trống.

newTextInput()

Tạo một TextInput mới.

Cầu thủ trả bóng

TextInput – Một TextInput trống.

newTextParagraph()

Tạo một TextParagraph mới.

Cầu thủ trả bóng

TextParagraph — Một Đoạn văn bản trống.

newTimePicker()

Tạo một TimePicker mới.

Cầu thủ trả bóng

TimePicker — Bộ chọn thời gian trống.

newUniversalActionResponseBuilder()

Tạo một UniversalActionResponseBuilder mới.

Cầu thủ trả bóng

UniversalActionResponseBuilder – Một trình tạo UniversalActionResponse trống.

newUpdateDraftActionResponseBuilder()

Tạo một UpdateDraftActionResponseBuilder mới.

Cầu thủ trả bóng

UpdateDraftActionResponseBuilder – một Update DraftActionResponseBuilder trống.

newUpdateDraftBccRecipientsAction()

Tạo một UpdateDraftBccRecipientsAction mới;

Cầu thủ trả bóng

UpdateDraftBccRecipientsAction — Một Update nhápBccBccsAction 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 Update draftCcSendersAction trống.

newUpdateDraftSubjectAction()

Tạo một UpdateDraftSubjectAction mới.

Cầu thủ trả bóng

UpdateDraftSubjectAction — Một Update DraftSubjectAction trống.

newUpdateDraftToRecipientsAction()

Tạo một UpdateDraftToRecipientsAction mới.

Cầu thủ trả bóng

UpdateDraftToRecipientsAction – Một Update draftToSendersAction trống.

newValidation()

Tạo một Validation mới.

Dùng được 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 – Thông tin xác thực trống.