此页面由 Cloud Translation API 翻译。

Class CardService

CardService 让您能够创建用于各种 Google 扩展产品（例如 Google Workspace 插件）的通用卡片。

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

或者，您也可以按如下方式返回多张卡片：

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

下面展示了如何定义包含标题、文本、图片和菜单项的卡片：

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

属性

属性	类型	说明
`BorderType`	`BorderType`	`BorderType` 枚举。
`ComposedEmailType`	`ComposedEmailType`	`ComposedEmailType` 枚举。
`ContentType`	`ContentType`	`ContentType` 枚举。
`GridItemLayout`	`GridItemLayout`	`GridItemLayout` 枚举。
`HorizontalAlignment`	`HorizontalAlignment`	`HorizontalAlignment` 枚举。
`Icon`	`Icon`	`Icon` 枚举。
`ImageCropType`	`ImageCropType`	`ImageCropType` 枚举。
`ImageStyle`	`ImageStyle`	`ImageStyle` 枚举。
`LoadIndicator`	`LoadIndicator`	`LoadIndicator` 枚举。
`OnClose`	`OnClose`	`OnClose` 枚举。
`OpenAs`	`OpenAs`	`OpenAs` 枚举。
`SelectionInputType`	`SelectionInputType`	`SelectionInputType` 枚举。
`TextButtonStyle`	`TextButtonStyle`	`TextButtonStyle` 枚举。
`UpdateDraftBodyType`	`UpdateDraftBodyType`	`UpdateDraftBodyType` 枚举。

方法

方法	返回类型	简介
`newAction()`	`Action`	创建新的 `Action`。
`newActionResponseBuilder()`	`ActionResponseBuilder`	创建新的 `ActionResponseBuilder`。
`newAttachment()`	`Attachment`	创建新的 `Attachment`。
`newAuthorizationAction()`	`AuthorizationAction`	创建新的 `AuthorizationAction`。
`newAuthorizationException()`	`AuthorizationException`	创建新的 `AuthorizationException`。
`newBorderStyle()`	`BorderStyle`	创建新的 `BorderStyle`。
`newButtonSet()`	`ButtonSet`	创建新的 `ButtonSet`。
`newCalendarEventActionResponseBuilder()`	`CalendarEventActionResponseBuilder`	创建新的 `CalendarEventActionResponseBuilder`。
`newCardAction()`	`CardAction`	创建新的 `CardAction`。
`newCardBuilder()`	`CardBuilder`	创建新的 `CardBuilder`。
`newCardHeader()`	`CardHeader`	创建新的 `CardHeader`。
`newCardSection()`	`CardSection`	创建新的 `CardSection`。
`newComposeActionResponseBuilder()`	`ComposeActionResponseBuilder`	创建新的 `ComposeActionResponseBuilder`。
`newDatePicker()`	`DatePicker`	创建新的 `DatePicker`。
`newDateTimePicker()`	`DateTimePicker`	创建新的 `DateTimePicker`。
`newDecoratedText()`	`DecoratedText`	创建新的 `DecoratedText`。
`newDivider()`	`Divider`	创建新的 `Divider`。
`newDriveItemsSelectedActionResponseBuilder()`	`DriveItemsSelectedActionResponseBuilder`	创建新的 `DriveItemsSelectedActionResponseBuilder`。
`newEditorFileScopeActionResponseBuilder()`	`EditorFileScopeActionResponseBuilder`	创建新的 `EditorFileScopeActionResponseBuilder`。
`newFixedFooter()`	`FixedFooter`	创建新的 `FixedFooter`。
`newGrid()`	`Grid`	创建新的 `Grid`。
`newGridItem()`	`GridItem`	创建新的 `GridItem`。
`newIconImage()`	`IconImage`	创建新的 `IconImage`。
`newImage()`	`Image`	创建新的 `Image`。
`newImageButton()`	`ImageButton`	创建新的 `ImageButton`。
`newImageComponent()`	`ImageComponent`	创建新的 `ImageComponent`。
`newImageCropStyle()`	`ImageCropStyle`	创建新的 `ImageCropStyle`。
`newKeyValue()`	`KeyValue`	创建新的 `KeyValue`。
`newNavigation()`	`Navigation`	创建新的 `Navigation`。
`newNotification()`	`Notification`	创建新的 `Notification`。
`newOpenLink()`	`OpenLink`	创建新的 `OpenLink`。
`newSelectionInput()`	`SelectionInput`	创建新的 `SelectionInput`。
`newSuggestions()`	`Suggestions`	创建新的 `Suggestions`。
`newSuggestionsResponseBuilder()`	`SuggestionsResponseBuilder`	创建新的 `SuggestionsResponseBuilder`。
`newSwitch()`	`Switch`	创建新的 `Switch`。
`newTextButton()`	`TextButton`	创建新的 `TextButton`。
`newTextInput()`	`TextInput`	创建新的 `TextInput`。
`newTextParagraph()`	`TextParagraph`	创建新的 `TextParagraph`。
`newTimePicker()`	`TimePicker`	创建新的 `TimePicker`。
`newUniversalActionResponseBuilder()`	`UniversalActionResponseBuilder`	创建新的 `UniversalActionResponseBuilder`。
`newUpdateDraftActionResponseBuilder()`	`UpdateDraftActionResponseBuilder`	创建新的 `UpdateDraftActionResponseBuilder`。
`newUpdateDraftBccRecipientsAction()`	`UpdateDraftBccRecipientsAction`	创建新的 `UpdateDraftBccRecipientsAction`；
`newUpdateDraftBodyAction()`	`UpdateDraftBodyAction`	创建新的 `UpdateDraftBodyAction`。
`newUpdateDraftCcRecipientsAction()`	`UpdateDraftCcRecipientsAction`	创建新的 `UpdateDraftCcRecipientsAction`。
`newUpdateDraftSubjectAction()`	`UpdateDraftSubjectAction`	创建新的 `UpdateDraftSubjectAction`。
`newUpdateDraftToRecipientsAction()`	`UpdateDraftToRecipientsAction`	创建新的 `UpdateDraftToRecipientsAction`。

详细文档

`newAction()`

创建新的 Action。

Action - 空 Action。

`newActionResponseBuilder()`

创建新的 ActionResponseBuilder。

ActionResponseBuilder - 空 ActionResponse 构建器。

`newAttachment()`

创建新的 Attachment。

Attachment - 附件为空。

`newAuthorizationAction()`

创建新的 AuthorizationAction。

AuthorizationAction - 空的 Action。

`newAuthorizationException()`

创建新的 AuthorizationException。

AuthorizationException - 空 AuthorizationException。

`newBorderStyle()`

创建新的 BorderStyle。

BorderStyle - 空的 BorderStyle。

`newButtonSet()`

创建新的 ButtonSet。

ButtonSet - 空 ButtonSet。

`newCalendarEventActionResponseBuilder()`

创建新的 CalendarEventActionResponseBuilder。

CalendarEventActionResponseBuilder - 空 CalendarEventActionResponseBuilder。

`newCardAction()`

创建新的 CardAction。

CardAction - 空的 CardAction。

`newCardBuilder()`

创建新的 CardBuilder。

CardBuilder - 卡片构建器为空。

`newCardHeader()`

创建新的 CardHeader。

CardHeader - 卡片为空。

`newCardSection()`

创建新的 CardSection。

CardSection - 空 CardSection。

`newComposeActionResponseBuilder()`

创建新的 ComposeActionResponseBuilder。

ComposeActionResponseBuilder - 空 ComposeActionResponse 构建器。

`newDatePicker()`

创建新的 DatePicker。

DatePicker - 日期选择器为空。

`newDateTimePicker()`

创建新的 DateTimePicker。

DateTimePicker - 日期时间选择器为空。

`newDecoratedText()`

创建新的 DecoratedText。

DecoratedText - 空的 DecoratedText。

`newDivider()`

创建新 Divider。以下示例构建了一个简单的卡片，其中包含 2 个段落，并以分隔线隔开。

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

Divider - 分隔线。

`newDriveItemsSelectedActionResponseBuilder()`

创建新的 DriveItemsSelectedActionResponseBuilder。

DriveItemsSelectedActionResponseBuilder - 空 DriveItemsSelectedActionResponseBuilder。

`newEditorFileScopeActionResponseBuilder()`

创建新的 EditorFileScopeActionResponseBuilder。

EditorFileScopeActionResponseBuilder - 空 EditorFileScopeActionResponseBuilder。

`newFixedFooter()`

创建新的 FixedFooter。

FixedFooter - 一个固定的 Footer。

`newGrid()`

创建新的 Grid。

Grid - 空网格。

`newGridItem()`

创建新的 GridItem。

GridItem - 空的 GridItem。

`newIconImage()`

创建新的 IconImage。

IconImage - 空白图标图片。

`newImage()`

创建新的 Image。

Image - 空图片。

`newImageButton()`

创建新的 ImageButton。

ImageButton - 空 ImageButton。

`newImageComponent()`

创建新的 ImageComponent。

ImageComponent - 空 ImageComponent。

`newImageCropStyle()`

创建新的 ImageCropStyle。

ImageCropStyle - 空 ImageCropStyle。

`newKeyValue()`

创建新的 KeyValue。

KeyValue - 空键值对。

`newNavigation()`

创建新的 Navigation。

Navigation - 空 Navigation。

`newNotification()`

创建新的 Notification。

Notification - 空通知。

`newOpenLink()`

创建新的 OpenLink。

OpenLink - 空 OpenLink。

`newSelectionInput()`

创建新的 SelectionInput。

SelectionInput - 空的 SelectionInput。

`newSuggestions()`

创建新的 Suggestions。

Suggestions - 空建议。

`newSuggestionsResponseBuilder()`

创建新的 SuggestionsResponseBuilder。

SuggestionsResponseBuilder - 空的 SuggestionResponse 构建器。

`newSwitch()`

创建新的 Switch。

Switch - 空的开关。

`newTextButton()`

创建新的 TextButton。

TextButton - 空 TextButton。

`newTextInput()`

创建新的 TextInput。

TextInput - 一个空的 TextInput。

`newTextParagraph()`

创建新的 TextParagraph。

TextParagraph - 空 TextParagraph。

`newTimePicker()`

创建新的 TimePicker。

TimePicker - 空的时间选择器。

`newUniversalActionResponseBuilder()`

创建新的 UniversalActionResponseBuilder。

UniversalActionResponseBuilder - 空的 UniversalActionResponse 构建器。

`newUpdateDraftActionResponseBuilder()`

创建新的 UpdateDraftActionResponseBuilder。

UpdateDraftActionResponseBuilder - 一个 UpdateUpdateActionResponseBuilder 为空。

`newUpdateDraftBccRecipientsAction()`

创建新的 UpdateDraftBccRecipientsAction；

UpdateDraftBccRecipientsAction - 一个空的草稿草稿 BCCRECIPIENTsAction。

`newUpdateDraftBodyAction()`

创建新的 UpdateDraftBodyAction。

UpdateDraftBodyAction - 一个空的 UpdateDraftBodyAction。

`newUpdateDraftCcRecipientsAction()`

创建新的 UpdateDraftCcRecipientsAction。

UpdateDraftCcRecipientsAction - 一个更新草稿草稿为空的 ActionAction。

`newUpdateDraftSubjectAction()`

创建新的 UpdateDraftSubjectAction。

UpdateDraftSubjectAction - 空 UpdateDraftSubjectAction。

`newUpdateDraftToRecipientsAction()`

创建新的 UpdateDraftToRecipientsAction。

UpdateDraftToRecipientsAction - 一个空的草稿草稿收件人。