Layanan
Berikut adalah contoh kartu add-on.
function createCard() { return CardService.newCardBuilder() .setHeader(CardService.newCardHeader().setTitle('CardTitle')) .build(); }
Atau, Anda dapat menampilkan beberapa Kartu seperti ini:
function createCards() { return [ CardService.newCardBuilder().build(), CardService.newCardBuilder().build(), CardService.newCardBuilder().build(), ]; }
Berikut ini cara menentukan kartu dengan header, teks, gambar, dan item 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(); }
Contoh untuk kartu Aplikasi 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();
Properti
| Properti | Jenis | Deskripsi |
|---|---|---|
Border | Border | Enumerasi Border. |
Chip | Chip | Enumerasi Chip. |
Composed | Composed | Enumerasi Composed. |
Content | Content | Enumerasi Content. |
Grid | Grid | Enumerasi Grid. |
Horizontal | Horizontal | Enumerasi Horizontal. |
Icon | Icon | Enumerasi Icon. |
Image | Image | Enumerasi Image. |
Image | Image | Enumerasi Image. |
Image | Image | Enumerasi Image. |
Input | Input | Enumerasi Input. |
Load | Load | Enumerasi Load. |
On | On | Enumerasi On. |
Open | Open | Enumerasi Open. |
Selection | Selection | Enumerasi Selection. |
Text | Text | Enumerasi Text. |
Update | Update | Enumerasi Update. |
Metode
Dokumentasi mendetail
new Action Response Builder()
Membuat Action baru.
Pulang pergi
Action — Builder ActionResponse kosong.
new Action Status()
Membuat Action baru.
Hanya tersedia untuk aplikasi Google Chat. Tidak tersedia untuk add-on Google Workspace.
const actionStatus = CardService.newActionStatus() .setStatusCode(CardService.Status.OK) .setUserFacingMessage('Success');
Pulang pergi
Action — ActionStatus kosong.
new Attachment()
new Authorization Action()
new Authorization Exception()
Membuat Authorization baru.
Pulang pergi
Authorization — AuthorizationException kosong.
new Border Style()
new Calendar Event Action Response Builder()
Membuat Calendar baru.
Pulang pergi
Calendar — Calendar kosong.
new Card Action()
new Card Builder()
new Card Header()
new Card Section()
new Card With Id()
Membuat Card baru. Ini digunakan untuk mengirim kartu dalam pesan Google Chat. ID kartu
adalah ID unik untuk kartu dalam pesan saat mengirim beberapa kartu.
Hanya tersedia untuk aplikasi Google Chat. Tidak tersedia untuk add-on 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);
Pulang pergi
Card — Card kosong.
new Carousel()
Membuat 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')))
Pulang pergi
Carousel — Carousel kosong.
new Carousel Card()
Membuat Carousel baru.
const carouselCard = CardService.newCarouselCard().addWidget( CardService.newTextParagraph().setText('Text paragraph in carousel'));
Pulang pergi
Carousel — Chip kosong.
new Chat Action Response()
Membuat Chat baru.
Hanya tersedia untuk aplikasi Google Chat. Tidak tersedia untuk add-on 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);
Pulang pergi
Chat — Chat kosong.
new Chat Response Builder()
Membuat Chat baru.
Hanya tersedia untuk aplikasi Google Chat. Tidak tersedia untuk add-on 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();
Pulang pergi
Chat — ChatResponseBuilder kosong.
new Chip()
new Chip List()
Membuat Chip baru.
Tersedia untuk aplikasi Google Chat. Dalam pratinjau developer untuk add-on Google Workspace.
const chip = CardService.newChip(); // Finish building the text chip... const chipList = CardService.newChipList() .setLayout(CardService.ChipListLayout.WRAPPED) .addChip(chip);
Pulang pergi
Chip — ChipList kosong.
new Collapse Control()
Membuat Collapse baru.
Tersedia untuk aplikasi Google Chat. Dalam pratinjau developer untuk add-on Google Workspace.
const collapseControl = CardService.newCollapseControl() .setHorizontalAlign(CardService.HorizontalAlignment.START) .setExpandButton(CardService.newTextButton().setText('Expand')) .setCollapseButton(CardService.newTextButton().setText('Collapse'));
Pulang pergi
Collapse — CollapseControl kosong.
new Column()
Membuat Column baru.
Tersedia untuk aplikasi Google Chat dan add-on 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);
Pulang pergi
Column — Kolom kosong.
new Columns()
Membuat kumpulan Columns baru.
Tersedia untuk aplikasi Google Chat dan add-on 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);
Pulang pergi
Columns — Kumpulan Kolom kosong.
new Compose Action Response Builder()
Membuat Compose baru.
Pulang pergi
Compose — Builder ComposeActionResponse kosong.
new Date Picker()
new Date Time Picker()
new Decorated Text()
new Dialog()
Membuat Dialog baru.
Hanya tersedia untuk aplikasi Google Chat. Tidak tersedia untuk add-on 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);
Pulang pergi
new Dialog Action()
Membuat Dialog baru.
Hanya tersedia untuk aplikasi Google Chat. Tidak tersedia untuk add-on 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);
Pulang pergi
Dialog — Dialog kosong.
new Divider()
Membuat Divider baru. Contoh berikut membuat kartu sederhana dengan 2 paragraf
yang dipisahkan oleh pemisah.
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; }
Pulang pergi
Divider — Pembagi.
new Drive Items Selected Action Response Builder()
Membuat Drive baru.
Pulang pergi
Drive — Drive kosong.
new Editor File Scope Action Response Builder()
Membuat Editor baru.
Pulang pergi
Editor — Editor kosong.
new Image Button()
new Image Component()
new Image Crop Style()
new Link Preview()
Membuat Link baru.
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');
Pulang pergi
Link — LinkPreview kosong.
new Material Icon()
Membuat Material baru.
Tersedia untuk aplikasi Google Chat dan add-on 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();
Pulang pergi
Material — MaterialIcon kosong.
new Notification()
new Overflow Menu()
Membuat Overflow baru.
Tersedia untuk aplikasi Google Chat. Dalam pratinjau developer untuk add-on Google Workspace.
const overflowMenuItem = CardService.newOverflowMenuItem(); // Finish building the overflow menu item... const overflowMenu = CardService.newOverflowMenu().addMenuItem(overflowMenuItem);
Pulang pergi
Overflow — OverflowMenu kosong.
new Overflow Menu Item()
Membuat Overflow baru.
Tersedia untuk aplikasi Google Chat. Dalam pratinjau developer untuk add-on 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'));
Pulang pergi
Overflow — OverflowMenuItem kosong.
new Selection Input()
new Suggestions()
new Suggestions Response Builder()
Membuat Suggestions baru.
Pulang pergi
Suggestions — Builder SuggestionsResponse kosong.
new Text Button()
new Text Paragraph()
new Time Picker()
new Universal Action Response Builder()
Membuat Universal baru.
Pulang pergi
Universal — Builder UniversalActionResponse kosong.
new Update Draft Action Response Builder()
Membuat Update baru.
Pulang pergi
Update — UpdateDraftActionResponseBuilder kosong.
new Update Draft Bcc Recipients Action()
Membuat Update baru;
Pulang pergi
Update — UpdateDraftBccRecipientsAction kosong.
new Update Draft Body Action()
Membuat Update baru.
Pulang pergi
Update — UpdateDraftBodyAction kosong.
new Update Draft Cc Recipients Action()
Membuat Update baru.
Pulang pergi
Update — UpdateDraftCcRecipientsAction Kosong.
new Update Draft Subject Action()
Membuat Update baru.
Pulang pergi
Update — UpdateDraftSubjectAction kosong.
new Update Draft To Recipients Action()
Membuat Update baru.
Pulang pergi
Update — UpdateDraftToRecipientsAction kosong.
new Validation()
Membuat Validation baru.
Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.
const validation = CardService.newValidation().setCharacterLimit(5).setInputType( CardService.InputType.EMAIL);
Pulang pergi
Validation — Validasi kosong.