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("[e-mail]"))
    .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("[phone]"))
    .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	Bản liệt kê BorderType.
ComposedEmailType	ComposedEmailType	Bản liệt kê ComposedEmailType.
ContentType	ContentType	Bản liệt kê ContentType.
GridItemLayout	GridItemLayout	Bản liệt kê GridItemLayout.
HorizontalAlignment	HorizontalAlignment	Bản liệt kê HorizontalAlignment.
Icon	Icon	Bản liệt kê Icon.
ImageCropType	ImageCropType	Bản liệt kê ImageCropType.
ImageStyle	ImageStyle	Bản liệt kê ImageStyle.
LoadIndicator	LoadIndicator	Bản liệt kê LoadIndicator.
OnClose	OnClose	Bản liệt kê OnClose.
OpenAs	OpenAs	Bản liệt kê OpenAs.
SelectionInputType	SelectionInputType	Bản liệt kê SelectionInputType.
TextButtonStyle	TextButtonStyle	Bản liệt kê TextButtonStyle.
UpdateDraftBodyType	UpdateDraftBodyType	Bản liệt kê UpdateDraftBodyType.

Phương thức

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
newAction()	Action	Tạo một Action mới.
newActionResponseBuilder()	ActionResponseBuilder	Tạo một ActionResponseBuilder mới.
newActionStatus()	ActionStatus	Tạo một ActionStatus mới.
newAttachment()	Attachment	Tạo một Attachment mới.
newAuthorizationAction()	AuthorizationAction	Tạo một AuthorizationAction mới.
newAuthorizationException()	AuthorizationException	Tạo một AuthorizationException mới.
newBorderStyle()	BorderStyle	Tạo một BorderStyle mới.
newButtonSet()	ButtonSet	Tạo một ButtonSet mới.
newCalendarEventActionResponseBuilder()	CalendarEventActionResponseBuilder	Tạo một CalendarEventActionResponseBuilder mới.
newCardAction()	CardAction	Tạo một CardAction mới.
newCardBuilder()	CardBuilder	Tạo một CardBuilder mới.
newCardHeader()	CardHeader	Tạo một CardHeader mới.
newCardSection()	CardSection	Tạo một CardSection mới.
newCardWithId()	CardWithId	Tạo một CardWithId mới.
newChatActionResponse()	ChatActionResponse	Tạo một ChatActionResponse mới.
newChatResponseBuilder()	ChatResponseBuilder	Tạo một ChatResponseBuilder mới.
newColumn()	Column	Tạo một Column mới.
newColumns()	Columns	Tạo một tập hợp Columns mới.
newComposeActionResponseBuilder()	ComposeActionResponseBuilder	Tạo một ComposeActionResponseBuilder mới.
newDatePicker()	DatePicker	Tạo một DatePicker mới.
newDateTimePicker()	DateTimePicker	Tạo một DateTimePicker mới.
newDecoratedText()	DecoratedText	Tạo một DecoratedText mới.
newDialog()	Dialog	Tạo một Dialog mới.
newDialogAction()	DialogAction	Tạo một DialogAction mới.
newDivider()	Divider	Tạo một Divider mới.
newDriveItemsSelectedActionResponseBuilder()	DriveItemsSelectedActionResponseBuilder	Tạo một DriveItemsSelectedActionResponseBuilder mới.
newEditorFileScopeActionResponseBuilder()	EditorFileScopeActionResponseBuilder	Tạo một EditorFileScopeActionResponseBuilder mới.
newFixedFooter()	FixedFooter	Tạo một FixedFooter mới.
newGrid()	Grid	Tạo một Grid mới.
newGridItem()	GridItem	Tạo một GridItem mới.
newIconImage()	IconImage	Tạo một IconImage mới.
newImage()	Image	Tạo một Image mới.
newImageButton()	ImageButton	Tạo một ImageButton mới.
newImageComponent()	ImageComponent	Tạo một ImageComponent mới.
newImageCropStyle()	ImageCropStyle	Tạo một ImageCropStyle mới.
newKeyValue()	KeyValue	Tạo một KeyValue mới.
newLinkPreview()	LinkPreview	Tạo một LinkPreview mới.
newNavigation()	Navigation	Tạo một Navigation mới.
newNotification()	Notification	Tạo một Notification mới.
newOpenLink()	OpenLink	Tạo một OpenLink mới.
newSelectionInput()	SelectionInput	Tạo một SelectionInput mới.
newSuggestions()	Suggestions	Tạo một Suggestions mới.
newSuggestionsResponseBuilder()	SuggestionsResponseBuilder	Tạo một SuggestionsResponseBuilder mới.
newSwitch()	Switch	Tạo một Switch mới.
newTextButton()	TextButton	Tạo một TextButton mới.
newTextInput()	TextInput	Tạo một TextInput mới.
newTextParagraph()	TextParagraph	Tạo một TextParagraph mới.
newTimePicker()	TimePicker	Tạo một TimePicker mới.
newUniversalActionResponseBuilder()	UniversalActionResponseBuilder	Tạo một UniversalActionResponseBuilder mới.
newUpdateDraftActionResponseBuilder()	UpdateDraftActionResponseBuilder	Tạo một UpdateDraftActionResponseBuilder mới.
newUpdateDraftBccRecipientsAction()	UpdateDraftBccRecipientsAction	Tạo một UpdateDraftBccRecipientsAction mới;
newUpdateDraftBodyAction()	UpdateDraftBodyAction	Tạo một UpdateDraftBodyAction mới.
newUpdateDraftCcRecipientsAction()	UpdateDraftCcRecipientsAction	Tạo một UpdateDraftCcRecipientsAction mới.
newUpdateDraftSubjectAction()	UpdateDraftSubjectAction	Tạo một UpdateDraftSubjectAction mới.
newUpdateDraftToRecipientsAction()	UpdateDraftToRecipientsAction	Tạo một UpdateDraftToRecipientsAction mới.
newValidation()	Validation	Tạ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()

Tạo một CalendarEventActionResponseBuilder mới.

Cầu thủ trả bóng

CalendarEventActionResponseBuilder — CalendarEventActionResponseBuilder trống.

---

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);

Bản dùng thử cho nhà phát triển: Được cung cấp trong Chương trình dùng thử Google Workspace cho nhà phát triển, chương trình này cấp quyền truy cập sớm vào một số tính năng.

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()

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

---

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.

---

newOpenLink()

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);

Bản dùng thử cho nhà phát triển: Được cung cấp trong Chương trình dùng thử Google Workspace cho nhà phát triển, chương trình này cấp quyền truy cập sớm vào một số tính năng.

Cầu thủ trả bóng

Validation – Thông tin xác thực trống.