Esta página foi traduzida pela API Cloud Translation.

Class CardService

O CardService permite criar cards genéricos usados em diferentes produtos de extensibilidade do Google, como os Complementos do Google Workspace.

Abaixo está um exemplo de cartão de complementos.

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

Também é possível retornar vários cards como os seguintes:

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

Confira a seguir como definir um card com cabeçalho, texto, imagem e um item de menu:

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

Exemplo de card de apps de 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();

Propriedades

Propriedade	Tipo	Descrição
`BorderType`	`BorderType`	A enumeração `BorderType`.
`ComposedEmailType`	`ComposedEmailType`	A enumeração `ComposedEmailType`.
`ContentType`	`ContentType`	A enumeração `ContentType`.
`GridItemLayout`	`GridItemLayout`	A enumeração `GridItemLayout`.
`HorizontalAlignment`	`HorizontalAlignment`	A enumeração `HorizontalAlignment`.
`Icon`	`Icon`	A enumeração `Icon`.
`ImageCropType`	`ImageCropType`	A enumeração `ImageCropType`.
`ImageStyle`	`ImageStyle`	A enumeração `ImageStyle`.
`LoadIndicator`	`LoadIndicator`	A enumeração `LoadIndicator`.
`OnClose`	`OnClose`	A enumeração `OnClose`.
`OpenAs`	`OpenAs`	A enumeração `OpenAs`.
`SelectionInputType`	`SelectionInputType`	A enumeração `SelectionInputType`.
`TextButtonStyle`	`TextButtonStyle`	A enumeração `TextButtonStyle`.
`UpdateDraftBodyType`	`UpdateDraftBodyType`	A enumeração `UpdateDraftBodyType`.

Métodos

Método	Tipo de retorno	Breve descrição
`newAction()`	`Action`	Crie um novo `Action`.
`newActionResponseBuilder()`	`ActionResponseBuilder`	Crie um novo `ActionResponseBuilder`.
`newActionStatus()`	`ActionStatus`	Crie um novo `ActionStatus`.
`newAttachment()`	`Attachment`	Crie um novo `Attachment`.
`newAuthorizationAction()`	`AuthorizationAction`	Crie um novo `AuthorizationAction`.
`newAuthorizationException()`	`AuthorizationException`	Crie um novo `AuthorizationException`.
`newBorderStyle()`	`BorderStyle`	Crie um novo `BorderStyle`.
`newButtonSet()`	`ButtonSet`	Crie um novo `ButtonSet`.
`newCalendarEventActionResponseBuilder()`	`CalendarEventActionResponseBuilder`	Crie um novo `CalendarEventActionResponseBuilder`.
`newCardAction()`	`CardAction`	Crie um novo `CardAction`.
`newCardBuilder()`	`CardBuilder`	Crie um novo `CardBuilder`.
`newCardHeader()`	`CardHeader`	Crie um novo `CardHeader`.
`newCardSection()`	`CardSection`	Crie um novo `CardSection`.
`newCardWithId()`	`CardWithId`	Crie um novo `CardWithId`.
`newChatActionResponse()`	`ChatActionResponse`	Crie um novo `ChatActionResponse`.
`newChatResponseBuilder()`	`ChatResponseBuilder`	Crie um novo `ChatResponseBuilder`.
`newComposeActionResponseBuilder()`	`ComposeActionResponseBuilder`	Crie um novo `ComposeActionResponseBuilder`.
`newDatePicker()`	`DatePicker`	Crie um novo `DatePicker`.
`newDateTimePicker()`	`DateTimePicker`	Crie um novo `DateTimePicker`.
`newDecoratedText()`	`DecoratedText`	Crie um novo `DecoratedText`.
`newDialog()`	`Dialog`	Crie um novo `Dialog`.
`newDialogAction()`	`DialogAction`	Crie um novo `DialogAction`.
`newDivider()`	`Divider`	Crie um novo `Divider`.
`newDriveItemsSelectedActionResponseBuilder()`	`DriveItemsSelectedActionResponseBuilder`	Crie um novo `DriveItemsSelectedActionResponseBuilder`.
`newEditorFileScopeActionResponseBuilder()`	`EditorFileScopeActionResponseBuilder`	Crie um novo `EditorFileScopeActionResponseBuilder`.
`newFixedFooter()`	`FixedFooter`	Crie um novo `FixedFooter`.
`newGrid()`	`Grid`	Crie um novo `Grid`.
`newGridItem()`	`GridItem`	Crie um novo `GridItem`.
`newIconImage()`	`IconImage`	Crie um novo `IconImage`.
`newImage()`	`Image`	Crie um novo `Image`.
`newImageButton()`	`ImageButton`	Crie um novo `ImageButton`.
`newImageComponent()`	`ImageComponent`	Crie um novo `ImageComponent`.
`newImageCropStyle()`	`ImageCropStyle`	Crie um novo `ImageCropStyle`.
`newKeyValue()`	`KeyValue`	Crie um novo `KeyValue`.
`newLinkPreview()`	`LinkPreview`	Crie um novo `LinkPreview`.
`newNavigation()`	`Navigation`	Crie um novo `Navigation`.
`newNotification()`	`Notification`	Crie um novo `Notification`.
`newOpenLink()`	`OpenLink`	Crie um novo `OpenLink`.
`newSelectionInput()`	`SelectionInput`	Crie um novo `SelectionInput`.
`newSuggestions()`	`Suggestions`	Crie um novo `Suggestions`.
`newSuggestionsResponseBuilder()`	`SuggestionsResponseBuilder`	Crie um novo `SuggestionsResponseBuilder`.
`newSwitch()`	`Switch`	Crie um novo `Switch`.
`newTextButton()`	`TextButton`	Crie um novo `TextButton`.
`newTextInput()`	`TextInput`	Crie um novo `TextInput`.
`newTextParagraph()`	`TextParagraph`	Crie um novo `TextParagraph`.
`newTimePicker()`	`TimePicker`	Crie um novo `TimePicker`.
`newUniversalActionResponseBuilder()`	`UniversalActionResponseBuilder`	Crie um novo `UniversalActionResponseBuilder`.
`newUpdateDraftActionResponseBuilder()`	`UpdateDraftActionResponseBuilder`	Crie um novo `UpdateDraftActionResponseBuilder`.
`newUpdateDraftBccRecipientsAction()`	`UpdateDraftBccRecipientsAction`	Cria um novo `UpdateDraftBccRecipientsAction`.
`newUpdateDraftBodyAction()`	`UpdateDraftBodyAction`	Crie um novo `UpdateDraftBodyAction`.
`newUpdateDraftCcRecipientsAction()`	`UpdateDraftCcRecipientsAction`	Crie um novo `UpdateDraftCcRecipientsAction`.
`newUpdateDraftSubjectAction()`	`UpdateDraftSubjectAction`	Crie um novo `UpdateDraftSubjectAction`.
`newUpdateDraftToRecipientsAction()`	`UpdateDraftToRecipientsAction`	Crie um novo `UpdateDraftToRecipientsAction`.

Documentação detalhada

`newAction()`

Crie um novo Action.

Retorno

Action: uma ação vazia.

`newActionResponseBuilder()`

Crie um novo ActionResponseBuilder.

Retorno

ActionResponseBuilder: um builder ActionResponse vazio.

`newActionStatus()`

Crie um novo ActionStatus.

Disponível apenas nos apps do Google Chat. Indisponível para complementos do Google Workspace.

const actionStatus = CardService.newActionStatus()
    .setStatusCode(CardService.Status.OK)
    .setUserFacingMessage('Success');

Retorno

ActionStatus: um ActionStatus vazio.

`newAttachment()`

Crie um novo Attachment.

Retorno

Attachment: um anexo vazio.

`newAuthorizationAction()`

Crie um novo AuthorizationAction.

Retorno

AuthorizationAction: uma AuthorizationAction vazia.

`newAuthorizationException()`

Crie um novo AuthorizationException.

Retorno

AuthorizationException: uma AuthorizationException vazia.

`newBorderStyle()`

Crie um novo BorderStyle.

Retorno

BorderStyle: um BorderStyle vazio.

`newButtonSet()`

Crie um novo ButtonSet.

Retorno

ButtonSet: um ButtonSet vazio.

`newCalendarEventActionResponseBuilder()`

Crie um novo CalendarEventActionResponseBuilder.

Retorno

CalendarEventActionResponseBuilder: uma CalendarEventActionResponseBuilder vazia.

`newCardAction()`

Crie um novo CardAction.

Retorno

CardAction: uma CardAction vazia.

`newCardBuilder()`

Crie um novo CardBuilder.

Retorno

CardBuilder: um criador de cards vazio.

`newCardHeader()`

Crie um novo CardHeader.

Retorno

CardHeader: um CardHeader vazio.

`newCardSection()`

Crie um novo CardSection.

Retorno

CardSection: uma CardSection vazia.

`newCardWithId()`

Crie um novo CardWithId. Ele é usado para enviar um cartão em uma mensagem do Google Chat. O ID do cartão é um identificador exclusivo de um cartão em uma mensagem ao enviar vários cartões.

Disponível apenas nos apps do Google Chat. Indisponível para complementos do 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);

Retorno

CardWithId: uma CardWithId vazia.

`newChatActionResponse()`

Crie um novo ChatActionResponse.

Disponível apenas nos apps do Google Chat. Indisponível para complementos do 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);

Retorno

ChatActionResponse: uma ChatActionResponse vazia.

`newChatResponseBuilder()`

Crie um novo ChatResponseBuilder.

Disponível apenas nos apps do Google Chat. Indisponível para complementos do 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();

Retorno

ChatResponseBuilder: um ChatResponseBuilder vazio.

`newComposeActionResponseBuilder()`

Crie um novo ComposeActionResponseBuilder.

Retorno

ComposeActionResponseBuilder: um builder ComposeActionResponse vazio.

`newDatePicker()`

Crie um novo DatePicker.

Retorno

DatePicker: um DatePicker vazio.

`newDateTimePicker()`

Crie um novo DateTimePicker.

Retorno

DateTimePicker: um DateTimePicker vazio.

`newDecoratedText()`

Crie um novo DecoratedText.

Retorno

DecoratedText: um DecoratedText vazio.

`newDialog()`

Crie um novo Dialog.

Disponível apenas nos apps do Google Chat. Indisponível para complementos do 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);

Retorno

Dialog: uma Dialog vazia.

`newDialogAction()`

Crie um novo DialogAction.

Disponível apenas nos apps do Google Chat. Indisponível para complementos do 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)

Retorno

DialogAction: uma DialogAction vazia.

`newDivider()`

Crie um novo Divider. O exemplo a seguir cria um card simples com dois parágrafos separados por um divisor.

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

Retorno

Divider: um divisor.

`newFixedFooter()`

Crie um novo FixedFooter.

Retorno

FixedFooter: um Rodapé fixo vazio.

`newGrid()`

Crie um novo Grid.

Retorno

Grid: uma grade vazia.

`newGridItem()`

Crie um novo GridItem.

Retorno

GridItem: um GridItem vazio.

`newIconImage()`

Crie um novo IconImage.

Retorno

IconImage: uma imagem de ícone vazia.

`newImage()`

Crie um novo Image.

Retorno

Image: uma imagem vazia.

`newImageButton()`

Crie um novo ImageButton.

Retorno

ImageButton: um ImageButton vazio.

`newImageComponent()`

Crie um novo ImageComponent.

Retorno

ImageComponent: um ImageComponent vazio.

`newImageCropStyle()`

Crie um novo ImageCropStyle.

Retorno

ImageCropStyle: um ImageCropStyle vazio.

`newKeyValue()`

Crie um novo KeyValue.

Retorno

KeyValue: um KeyValue vazio.

`newLinkPreview()`

Crie um novo LinkPreview.

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

Retorno

LinkPreview: um LinkPreview vazio.

`newNavigation()`

Crie um novo Navigation.

Retorno

Navigation: uma navegação vazia.

`newNotification()`

Crie um novo Notification.

Retorno

Notification: uma notificação vazia.

`newOpenLink()`

Crie um novo OpenLink.

Retorno

OpenLink: um OpenLink vazio.

`newSelectionInput()`

Crie um novo SelectionInput.

Retorno

SelectionInput: um SelectionInput vazio.

`newSuggestions()`

Crie um novo Suggestions.

Retorno

Suggestions: uma sugestão vazia.

`newSuggestionsResponseBuilder()`

Crie um novo SuggestionsResponseBuilder.

Retorno

SuggestionsResponseBuilder: um builder SuggestionsResponse vazio.

`newSwitch()`

Crie um novo Switch.

Retorno

Switch: um interruptor vazio.

`newTextButton()`

Crie um novo TextButton.

Retorno

TextButton: um TextButton vazio.

`newTextInput()`

Crie um novo TextInput.

Retorno

TextInput: um TextInput vazio.

`newTextParagraph()`

Crie um novo TextParagraph.

Retorno

TextParagraph: um Textparagraph vazio.

`newTimePicker()`

Crie um novo TimePicker.

Retorno

TimePicker: um TimePicker vazio.

`newUniversalActionResponseBuilder()`

Crie um novo UniversalActionResponseBuilder.

Retorno

UniversalActionResponseBuilder: um builder UniversalActionResponse vazio.

`newUpdateDraftActionResponseBuilder()`

Crie um novo UpdateDraftActionResponseBuilder.

Retorno

UpdateDraftActionResponseBuilder: um UpdateRascunhoActionResponseBuilder vazio.

`newUpdateDraftBccRecipientsAction()`

Cria um novo UpdateDraftBccRecipientsAction;

Retorno

UpdateDraftBccRecipientsAction: uma UpdateDraftBccRecipientsAction vazia.

`newUpdateDraftBodyAction()`

Crie um novo UpdateDraftBodyAction.

Retorno

UpdateDraftBodyAction: uma UpdateDraftBodyAction vazia.

`newUpdateDraftCcRecipientsAction()`

Crie um novo UpdateDraftCcRecipientsAction.

Retorno

UpdateDraftCcRecipientsAction: uma UpdateRascunhoCcRecipientsAction vazio.

`newUpdateDraftSubjectAction()`

Crie um novo UpdateDraftSubjectAction.

Retorno

UpdateDraftSubjectAction: uma UpdateDraftSubjectAction vazia.

`newUpdateDraftToRecipientsAction()`

Crie um novo UpdateDraftToRecipientsAction.

Retorno

UpdateDraftToRecipientsAction: uma UpdateDraftToRecipientsAction vazia.

Class CardService

Propriedades

Métodos

Documentação detalhada

newAction()

Retorno

newActionResponseBuilder()

Retorno

newActionStatus()

Retorno

newAttachment()

Retorno

newAuthorizationAction()

Retorno

newAuthorizationException()

Retorno

newBorderStyle()

Retorno

newButtonSet()

Retorno

newCalendarEventActionResponseBuilder()

Retorno

newCardAction()

Retorno

newCardBuilder()

Retorno

newCardHeader()

Retorno

newCardSection()

Retorno

newCardWithId()

Retorno

newChatActionResponse()

Retorno

newChatResponseBuilder()

Retorno

newComposeActionResponseBuilder()

Retorno

newDatePicker()

Retorno

newDateTimePicker()

Retorno

newDecoratedText()

Retorno

newDialog()

Retorno

newDialogAction()

Retorno

newDivider()

Retorno

newDriveItemsSelectedActionResponseBuilder()

Retorno

newEditorFileScopeActionResponseBuilder()

Retorno

newFixedFooter()

Retorno

newGrid()

Retorno

newGridItem()

Retorno

newIconImage()

Retorno

newImage()

Retorno

newImageButton()

Retorno

newImageComponent()

Retorno

newImageCropStyle()

Retorno

newKeyValue()

Retorno

newLinkPreview()

Retorno

newNavigation()

Retorno

newNotification()

Retorno

newOpenLink()

Retorno

`newAction()`

`newActionResponseBuilder()`

`newActionStatus()`

`newAttachment()`

`newAuthorizationAction()`

`newAuthorizationException()`

`newBorderStyle()`

`newButtonSet()`

`newCalendarEventActionResponseBuilder()`

`newCardAction()`

`newCardBuilder()`

`newCardHeader()`

`newCardSection()`

`newCardWithId()`

`newChatActionResponse()`

`newChatResponseBuilder()`

`newComposeActionResponseBuilder()`

`newDatePicker()`

`newDateTimePicker()`

`newDecoratedText()`

`newDialog()`

`newDialogAction()`

`newDivider()`

`newDriveItemsSelectedActionResponseBuilder()`

`newEditorFileScopeActionResponseBuilder()`

`newFixedFooter()`

`newGrid()`

`newGridItem()`

`newIconImage()`

`newImage()`

`newImageButton()`

`newImageComponent()`

`newImageCropStyle()`

`newKeyValue()`

`newLinkPreview()`

`newNavigation()`

`newNotification()`

`newOpenLink()`

`newSelectionInput()`

`newSuggestions()`

`newSuggestionsResponseBuilder()`

`newSwitch()`

`newTextButton()`

`newTextInput()`

`newTextParagraph()`

`newTimePicker()`

`newUniversalActionResponseBuilder()`

`newUpdateDraftActionResponseBuilder()`

`newUpdateDraftBccRecipientsAction()`

`newUpdateDraftBodyAction()`

`newUpdateDraftCcRecipientsAction()`

`newUpdateDraftSubjectAction()`

`newUpdateDraftToRecipientsAction()`