Il
Di seguito è riportato un esempio di scheda di componenti aggiuntivi.
function createCard() { return CardService.newCardBuilder() .setHeader(CardService.newCardHeader().setTitle('CardTitle')) .build(); }
In alternativa, puoi restituire più schede nel seguente modo:
function createCards() { return [ CardService.newCardBuilder().build(), CardService.newCardBuilder().build(), CardService.newCardBuilder().build(), ]; }
Di seguito viene mostrato come definire una scheda con un'intestazione, un testo, un'immagine e un elemento 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 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('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();
Proprietà
| Proprietà | Tipo | Descrizione |
|---|---|---|
Border | Border | L'enumerazione Border. |
Chip | Chip | L'enumerazione Chip. |
Composed | Composed | L'enumerazione Composed. |
Content | Content | L'enumerazione Content. |
Grid | Grid | L'enumerazione Grid. |
Horizontal | Horizontal | L'enumerazione Horizontal. |
Icon | Icon | L'enumerazione Icon. |
Image | Image | L'enumerazione Image. |
Image | Image | L'enumerazione Image. |
Image | Image | L'enumerazione Image. |
Input | Input | L'enumerazione Input. |
Load | Load | L'enumerazione Load. |
On | On | L'enumerazione On. |
Open | Open | L'enumerazione Open. |
Selection | Selection | L'enumerazione Selection. |
Text | Text | L'enumerazione Text. |
Update | Update | L'enumerazione Update. |
Metodi
Documentazione dettagliata
new Action Response Builder()
Crea un nuovo Action.
Invio
Action: uno strumento per la creazione di ActionResponse vuoto.
new Action Status()
Crea un nuovo Action.
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
Action: un ActionStatus vuoto.
new Attachment()
new Authorization Action()
new Authorization Exception()
Crea un nuovo Authorization.
Invio
Authorization: un'AuthorizationException vuota.
new Border Style()
new Calendar Event Action Response Builder()
Crea un nuovo Calendar.
Invio
Calendar: un Calendar vuoto.
new Card Action()
new Card Builder()
new Card Header()
new Card Section()
new Card With Id()
Crea un nuovo Card. Viene utilizzato per inviare una scheda in un messaggio di Google Chat. L'ID scheda è un identificatore univoco di una scheda in un messaggio quando vengono inviate più schede.
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
Card: un Card vuoto.
new Carousel()
Crea un Carousel.
const carousel = CardService.newCarousel() .addCarouselCard(CardService.newCarouselCard().addWidget( CardService.newTextParagraph().setText('The first text paragraph in carousel'))) .addCarouselCard(CardService.newCarouselCard().addWidget( CardService.newTextParagraph().setText('The second text paragraph in carousel'))) .addCarouselCard(CardService.newCarouselCard().addWidget( CardService.newTextParagraph().setText('The third text paragraph in carousel')))
Invio
Carousel: un carosello vuoto.
new Carousel Card()
Crea un nuovo Carousel.
const carouselCard = CardService.newCarouselCard().addWidget( CardService.newTextParagraph().setText('Text paragraph in carousel'));
Invio
Carousel: un chip vuoto.
new Chat Action Response()
Crea un nuovo Chat.
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
Chat: un Chat vuoto.
new Chat Response Builder()
Crea un nuovo Chat.
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
Chat: un ChatResponseBuilder vuoto.
new Chip()
new Chip List()
Crea un nuovo Chip.
Disponibile per le app Google Chat. In anteprima per sviluppatori per i componenti aggiuntivi di Google Workspace.
const chip = CardService.newChip(); // Finish building the text chip... const chipList = CardService.newChipList() .setLayout(CardService.ChipListLayout.WRAPPED) .addChip(chip);
Invio
Chip: un ChipList vuoto.
new Collapse Control()
Crea un nuovo Collapse.
Disponibile per le app Google Chat. In anteprima per sviluppatori per i componenti aggiuntivi di Google Workspace.
const collapseControl = CardService.newCollapseControl() .setHorizontalAlign(CardService.HorizontalAlignment.START) .setExpandButton(CardService.newTextButton().setText('Expand')) .setCollapseButton(CardService.newTextButton().setText('Collapse'));
Invio
Collapse: un CollapseControl vuoto.
new Column()
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);
Invio
Column: una colonna vuota.
new Columns()
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(firstColumn) .addColumn(secondColumn) .setWrapStyle(CardService.WrapStyle.WRAP);
Invio
Columns: un insieme vuoto di colonne.
new Compose Action Response Builder()
Crea un nuovo Compose.
Invio
Compose: un generatore di ComposeActionResponse vuoto.
new Date Picker()
new Date Time Picker()
new Decorated Text()
new Dialog()
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
new Dialog Action()
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(); const dialog = CardService.newDialog().setBody(card); const dialogAction = CardService.newDialogAction().setDialog(dialog);
Invio
Dialog: un Dialog vuoto.
new Divider()
Crea un nuovo Divider. Il seguente esempio crea una scheda semplice con due paragrafi
separati da un divisore.
function buildCard() { const cardSection1TextParagraph1 = CardService.newTextParagraph().setText('Hello world!'); const cardSection1Divider1 = CardService.newDivider(); const cardSection1TextParagraph2 = CardService.newTextParagraph().setText('Hello world!'); const cardSection1 = CardService.newCardSection() .addWidget(cardSection1TextParagraph1) .addWidget(cardSection1Divider1) .addWidget(cardSection1TextParagraph2); const card = CardService.newCardBuilder().addSection(cardSection1).build(); return card; }
Invio
Divider: un divisore.
new Drive Items Selected Action Response Builder()
Crea un nuovo Drive.
Invio
Drive: un Drive vuoto.
new Editor File Scope Action Response Builder()
Crea un nuovo Editor.
Invio
Editor: un Editor vuoto.
new Image Button()
new Image Component()
new Image Crop Style()
new Link Preview()
Crea un nuovo Link.
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
Link: un oggetto LinkPreview vuoto.
new Material Icon()
Crea un nuovo Material.
Disponibile per le app Google Chat e i componenti aggiuntivi di Google Workspace.
const materialIcon = CardService.newMaterialIcon().setName('check_box').setFill(true); const cardSection = CardService.newCardSection(); cardSection.addWidget( CardService.newDecoratedText() .setStartIcon(CardService.newIconImage().setMaterialIcon(materialIcon)) .setText('sasha@example.com'), ); const card = CardService.newCardBuilder() .setHeader(CardService.newCardHeader().setTitle('Card Title')) .addSection(cardSection) .build();
Invio
Material: un'icona Material vuota.
new Notification()
new Overflow Menu()
Crea un nuovo Overflow.
Disponibile per le app Google Chat. In anteprima per sviluppatori per i componenti aggiuntivi di Google Workspace.
const overflowMenuItem = CardService.newOverflowMenuItem(); // Finish building the overflow menu item... const overflowMenu = CardService.newOverflowMenu().addMenuItem(overflowMenuItem);
Invio
Overflow: un OverflowMenu vuoto.
new Overflow Menu Item()
Crea un nuovo Overflow.
Disponibile per le app Google Chat. In anteprima per sviluppatori per i componenti aggiuntivi di Google Workspace.
const overflowMenuItem = CardService.newOverflowMenuItem() .setStartIcon( CardService.newIconImage().setIconUrl( 'https://www.google.com/images/branding/googleg/1x/googleg_standard_color_64dp.png', ), ) .setText('Open Link') .setOpenLink( CardService.newOpenLink().setUrl('https://www.google.com'));
Invio
Overflow: un OverflowMenuItem vuoto.
new Selection Input()
new Suggestions()
new Suggestions Response Builder()
Crea un nuovo Suggestions.
Invio
Suggestions: un generatore di SuggestionsResponse vuoto.
new Text Button()
new Text Paragraph()
new Time Picker()
new Universal Action Response Builder()
Crea un nuovo Universal.
Invio
Universal: un generatore di UniversalActionResponse vuoto.
new Update Draft Action Response Builder()
Crea un nuovo Update.
Invio
Update: un UpdateDraftActionResponseBuilder vuoto.
new Update Draft Bcc Recipients Action()
Crea un nuovo Update.
Invio
Update: un'azione UpdateDraftBccRecipientsAction vuota.
new Update Draft Body Action()
Crea un nuovo Update.
Invio
Update: un'azione UpdateDraftBodyAction vuota.
new Update Draft Cc Recipients Action()
Crea un nuovo Update.
Invio
Update: un'azione UpdateDraftCcRecipientsAction vuota.
new Update Draft Subject Action()
Crea un nuovo Update.
Invio
Update: un'azione UpdateDraftSubjectAction vuota.
new Update Draft To Recipients Action()
Crea un nuovo Update.
Invio
Update: un'azione UpdateDraftToRecipientsAction vuota.
new Validation()
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);
Invio
Validation: una convalida vuota.