Class CardService

CardService

CardService consente di creare carte generiche utilizzate su diverse piattaforme Google prodotti di estensibilità come i componenti aggiuntivi di Google Workspace.

Di seguito è riportato un esempio di scheda dei componenti aggiuntivi.

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

In alternativa, puoi restituire più Carte, ad esempio:

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

Di seguito viene illustrato come definire una scheda con un'intestazione, del testo, un'immagine e una voce di 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();
}

Esempio di una scheda App di 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();

Proprietà

Proprietà	Tipo	Descrizione
BorderType	BorderType	L'enumerazione BorderType.
ComposedEmailType	ComposedEmailType	L'enumerazione ComposedEmailType.
ContentType	ContentType	L'enumerazione ContentType.
GridItemLayout	GridItemLayout	L'enumerazione GridItemLayout.
HorizontalAlignment	HorizontalAlignment	L'enumerazione HorizontalAlignment.
Icon	Icon	L'enumerazione Icon.
ImageCropType	ImageCropType	L'enumerazione ImageCropType.
ImageStyle	ImageStyle	L'enumerazione ImageStyle.
LoadIndicator	LoadIndicator	L'enumerazione LoadIndicator.
OnClose	OnClose	L'enumerazione OnClose.
OpenAs	OpenAs	L'enumerazione OpenAs.
SelectionInputType	SelectionInputType	L'enumerazione SelectionInputType.
TextButtonStyle	TextButtonStyle	L'enumerazione TextButtonStyle.
UpdateDraftBodyType	UpdateDraftBodyType	L'enumerazione UpdateDraftBodyType.

Metodi

Metodo	Tipo restituito	Breve descrizione
newAction()	Action	Crea un nuovo Action.
newActionResponseBuilder()	ActionResponseBuilder	Crea un nuovo ActionResponseBuilder.
newActionStatus()	ActionStatus	Crea un nuovo ActionStatus.
newAttachment()	Attachment	Crea un nuovo Attachment.
newAuthorizationAction()	AuthorizationAction	Crea un nuovo AuthorizationAction.
newAuthorizationException()	AuthorizationException	Crea un nuovo AuthorizationException.
newBorderStyle()	BorderStyle	Crea un nuovo BorderStyle.
newButtonSet()	ButtonSet	Crea un nuovo ButtonSet.
newCalendarEventActionResponseBuilder()	CalendarEventActionResponseBuilder	Crea un nuovo CalendarEventActionResponseBuilder.
newCardAction()	CardAction	Crea un nuovo CardAction.
newCardBuilder()	CardBuilder	Crea un nuovo CardBuilder.
newCardHeader()	CardHeader	Crea un nuovo CardHeader.
newCardSection()	CardSection	Crea un nuovo CardSection.
newCardWithId()	CardWithId	Crea un nuovo CardWithId.
newChatActionResponse()	ChatActionResponse	Crea un nuovo ChatActionResponse.
newChatResponseBuilder()	ChatResponseBuilder	Crea un nuovo ChatResponseBuilder.
newColumn()	Column	Crea un nuovo Column.
newColumns()	Columns	Crea un nuovo insieme di Columns.
newComposeActionResponseBuilder()	ComposeActionResponseBuilder	Crea un nuovo ComposeActionResponseBuilder.
newDatePicker()	DatePicker	Crea un nuovo DatePicker.
newDateTimePicker()	DateTimePicker	Crea un nuovo DateTimePicker.
newDecoratedText()	DecoratedText	Crea un nuovo DecoratedText.
newDialog()	Dialog	Crea un nuovo Dialog.
newDialogAction()	DialogAction	Crea un nuovo DialogAction.
newDivider()	Divider	Crea un nuovo Divider.
newDriveItemsSelectedActionResponseBuilder()	DriveItemsSelectedActionResponseBuilder	Crea un nuovo DriveItemsSelectedActionResponseBuilder.
newEditorFileScopeActionResponseBuilder()	EditorFileScopeActionResponseBuilder	Crea un nuovo EditorFileScopeActionResponseBuilder.
newFixedFooter()	FixedFooter	Crea un nuovo FixedFooter.
newGrid()	Grid	Crea un nuovo Grid.
newGridItem()	GridItem	Crea un nuovo GridItem.
newIconImage()	IconImage	Crea un nuovo IconImage.
newImage()	Image	Crea un nuovo Image.
newImageButton()	ImageButton	Crea un nuovo ImageButton.
newImageComponent()	ImageComponent	Crea un nuovo ImageComponent.
newImageCropStyle()	ImageCropStyle	Crea un nuovo ImageCropStyle.
newKeyValue()	KeyValue	Crea un nuovo KeyValue.
newLinkPreview()	LinkPreview	Crea un nuovo LinkPreview.
newNavigation()	Navigation	Crea un nuovo Navigation.
newNotification()	Notification	Crea un nuovo Notification.
newOpenLink()	OpenLink	Crea un nuovo OpenLink.
newSelectionInput()	SelectionInput	Crea un nuovo SelectionInput.
newSuggestions()	Suggestions	Crea un nuovo Suggestions.
newSuggestionsResponseBuilder()	SuggestionsResponseBuilder	Crea un nuovo SuggestionsResponseBuilder.
newSwitch()	Switch	Crea un nuovo Switch.
newTextButton()	TextButton	Crea un nuovo TextButton.
newTextInput()	TextInput	Crea un nuovo TextInput.
newTextParagraph()	TextParagraph	Crea un nuovo TextParagraph.
newTimePicker()	TimePicker	Crea un nuovo TimePicker.
newUniversalActionResponseBuilder()	UniversalActionResponseBuilder	Crea un nuovo UniversalActionResponseBuilder.
newUpdateDraftActionResponseBuilder()	UpdateDraftActionResponseBuilder	Crea un nuovo UpdateDraftActionResponseBuilder.
newUpdateDraftBccRecipientsAction()	UpdateDraftBccRecipientsAction	Crea un nuovo UpdateDraftBccRecipientsAction;
newUpdateDraftBodyAction()	UpdateDraftBodyAction	Crea un nuovo UpdateDraftBodyAction.
newUpdateDraftCcRecipientsAction()	UpdateDraftCcRecipientsAction	Crea un nuovo UpdateDraftCcRecipientsAction.
newUpdateDraftSubjectAction()	UpdateDraftSubjectAction	Crea un nuovo UpdateDraftSubjectAction.
newUpdateDraftToRecipientsAction()	UpdateDraftToRecipientsAction	Crea un nuovo UpdateDraftToRecipientsAction.
newValidation()	Validation	Crea un nuovo Validation.

Documentazione dettagliata

newAction()

Crea un nuovo Action.

Invio

Action: un'azione vuota.

---

newActionResponseBuilder()

Crea un nuovo ActionResponseBuilder.

Invio

ActionResponseBuilder: un builder ActionResponse vuoto.

---

newActionStatus()

Crea un nuovo ActionStatus.

Disponibile solo per le app Google Chat. Non disponibile per i componenti aggiuntivi di Google Workspace.

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

Invio

ActionStatus: un valore ActionStatus vuoto.

---

newAttachment()

Crea un nuovo Attachment.

Invio

Attachment: un allegato vuoto.

---

newAuthorizationAction()

Crea un nuovo AuthorizationAction.

Invio

AuthorizationAction: un'azione di autorizzazione vuota.

---

newAuthorizationException()

Crea un nuovo AuthorizationException.

Invio

AuthorizationException: un'eccezione di autorizzazione vuota.

---

newBorderStyle()

Crea un nuovo BorderStyle.

Invio

BorderStyle: un BorderStyle vuoto.

---

newButtonSet()

Crea un nuovo ButtonSet.

Invio

ButtonSet: un set di pulsanti vuoto.

---

newCalendarEventActionResponseBuilder()

Crea un nuovo CalendarEventActionResponseBuilder.

Invio

CalendarEventActionResponseBuilder: un valore CalendarEventActionResponseBuilder vuoto.

---

newCardAction()

Crea un nuovo CardAction.

Invio

CardAction: una CardAction vuota.

---

newCardBuilder()

Crea un nuovo CardBuilder.

Invio

CardBuilder: un generatore di schede vuoto.

---

newCardHeader()

Crea un nuovo CardHeader.

Invio

CardHeader: una CardHeader vuota.

---

newCardSection()

Crea un nuovo CardSection.

Invio

CardSection: una CardSezione vuota.

---

newCardWithId()

Crea un nuovo CardWithId. Viene utilizzato per inviare una scheda in un messaggio di Google Chat. ID carta è un identificatore univoco di una scheda in un messaggio quando vengono inviate più carte.

Disponibile solo per le app Google Chat. Non disponibile per i componenti aggiuntivi di 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);

Invio

CardWithId: un valore CardWithId vuoto.

---

newChatActionResponse()

Crea un nuovo ChatActionResponse.

Disponibile solo per le app Google Chat. Non disponibile per i componenti aggiuntivi di 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);

Invio

ChatActionResponse: un valore ChatActionResponse vuoto.

---

newChatResponseBuilder()

Crea un nuovo ChatResponseBuilder.

Disponibile solo per le app Google Chat. Non disponibile per i componenti aggiuntivi di 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();

Invio

ChatResponseBuilder: un messaggio ChatResponseBuilder vuoto.

---

newColumn()

Crea un nuovo Column.

Disponibile per le app Google Chat e i componenti aggiuntivi di 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: colonna vuota.

---

newColumns()

Crea un nuovo insieme di Columns.

Disponibile per le app Google Chat e i componenti aggiuntivi di 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);

Anteprima per gli sviluppatori: disponibile nell'ambito del Programma Anteprima per gli sviluppatori di Google Workspace, che garantisce l'accesso in anteprima ad alcune funzionalità.

Invio

Columns: un insieme di colonne vuoto.

---

newComposeActionResponseBuilder()

Crea un nuovo ComposeActionResponseBuilder.

Invio

ComposeActionResponseBuilder: un generatore ComposeActionResponse vuoto.

---

newDatePicker()

Crea un nuovo DatePicker.

Invio

DatePicker: un selettore della data vuoto.

---

newDateTimePicker()

Crea un nuovo DateTimePicker.

Invio

DateTimePicker: un selettore di data/ora vuoto.

---

newDecoratedText()

Crea un nuovo DecoratedText.

Invio

DecoratedText: un DecorText vuoto.

---

newDialog()

Crea un nuovo Dialog.

Disponibile solo per le app Google Chat. Non disponibile per i componenti aggiuntivi di 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);

Invio

Dialog: un valore Dialog vuoto.

---

newDialogAction()

Crea un nuovo DialogAction.

Disponibile solo per le app Google Chat. Non disponibile per i componenti aggiuntivi di 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)

Invio

DialogAction: un valore DialogAction vuoto.

---

newDivider()

Crea un nuovo Divider. Il seguente esempio crea una semplice scheda con due paragrafi separate da un divisore.

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

Invio

Divider: un divisore.

---

newDriveItemsSelectedActionResponseBuilder()

Crea un nuovo DriveItemsSelectedActionResponseBuilder.

Invio

DriveItemsSelectedActionResponseBuilder: un valore DriveItemsSelectedActionResponseBuilder vuoto.

---

newEditorFileScopeActionResponseBuilder()

Crea un nuovo EditorFileScopeActionResponseBuilder.

Invio

EditorFileScopeActionResponseBuilder: un valore EditorFileScopeActionResponseBuilder vuoto.

---

newFixedFooter()

Crea un nuovo FixedFooter.

Invio

FixedFooter: un piè di pagina fisso vuoto.

---

newGrid()

Crea un nuovo Grid.

Invio

Grid: una griglia vuota.

---

newGridItem()

Crea un nuovo GridItem.

Invio

GridItem: un elemento GridItem vuoto.

---

newIconImage()

Crea un nuovo IconImage.

Invio

IconImage: immagine di un'icona vuota.

---

newImage()

Crea un nuovo Image.

Invio

Image: un'immagine vuota.

---

newImageButton()

Crea un nuovo ImageButton.

Invio

ImageButton: un elemento ImageButton vuoto.

---

newImageComponent()

Crea un nuovo ImageComponent.

Invio

ImageComponent: un elemento ImageComponent vuoto.

---

newImageCropStyle()

Crea un nuovo ImageCropStyle.

Invio

ImageCropStyle: un elemento ImageRitagliaStyle vuoto.

---

newKeyValue()

Crea un nuovo KeyValue.

Invio

KeyValue: una coppia chiave-valore vuota.

---

newLinkPreview()

Crea un nuovo 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');

Invio

LinkPreview: un'anteprima Link vuota.

---

newNavigation()

Crea un nuovo Navigation.

Invio

Navigation: un riquadro di navigazione vuoto.

---

newNotification()

Crea un nuovo Notification.

Invio

Notification: una notifica vuota.

---

newOpenLink()

Crea un nuovo OpenLink.

Invio

OpenLink: un OpenLink vuoto.

---

newSelectionInput()

Crea un nuovo SelectionInput.

Invio

SelectionInput: un valore SelectionInput vuoto.

---

newSuggestions()

Crea un nuovo Suggestions.

Invio

Suggestions: un suggerimento vuoto.

---

newSuggestionsResponseBuilder()

Crea un nuovo SuggestionsResponseBuilder.

Invio

SuggestionsResponseBuilder: un generatore SuggestionsResponse vuoto.

---

newSwitch()

Crea un nuovo Switch.

Invio

Switch: un sensore vuoto.

---

newTextButton()

Crea un nuovo TextButton.

Invio

TextButton: un TextButton vuoto.

---

newTextInput()

Crea un nuovo TextInput.

Invio

TextInput: un TextInput vuoto.

---

newTextParagraph()

Crea un nuovo TextParagraph.

Invio

TextParagraph: un TextParagraph vuoto.

---

newTimePicker()

Crea un nuovo TimePicker.

Invio

TimePicker: un selettore temporale vuoto.

---

newUniversalActionResponseBuilder()

Crea un nuovo UniversalActionResponseBuilder.

Invio

UniversalActionResponseBuilder: un builder UniversalActionResponse vuoto.

---

newUpdateDraftActionResponseBuilder()

Crea un nuovo UpdateDraftActionResponseBuilder.

Invio

UpdateDraftActionResponseBuilder: un UpdateDraftActionResponseBuilder vuoto.

---

newUpdateDraftBccRecipientsAction()

Crea un nuovo UpdateDraftBccRecipientsAction;

Invio

UpdateDraftBccRecipientsAction: un valore UpdateDraftBccRecipientsAction vuoto.

---

newUpdateDraftBodyAction()

Crea un nuovo UpdateDraftBodyAction.

Invio

UpdateDraftBodyAction: un valore UpdateDraftBodyAction vuoto.

---

newUpdateDraftCcRecipientsAction()

Crea un nuovo UpdateDraftCcRecipientsAction.

Invio

UpdateDraftCcRecipientsAction: un'azione UpdateDraftCcRecipientsAction vuota.

---

newUpdateDraftSubjectAction()

Crea un nuovo UpdateDraftSubjectAction.

Invio

UpdateDraftSubjectAction: un valore UpdateDraftSubjectAction vuoto.

---

newUpdateDraftToRecipientsAction()

Crea un nuovo UpdateDraftToRecipientsAction.

Invio

UpdateDraftToRecipientsAction: un valore UpdateDraftToRecipientsAction vuoto.

---

newValidation()

Crea un nuovo Validation.

Disponibile per le app Google Chat e i componenti aggiuntivi di Google Workspace.

const validation = CardService.newValidation()
    .setCharacterLimit(5)
    .setInputType(CardService.InputType.EMAIL);

Anteprima per gli sviluppatori: disponibile nell'ambito del Programma Anteprima per gli sviluppatori di Google Workspace, che garantisce l'accesso in anteprima ad alcune funzionalità.

Invio

Validation: una convalida vuota.