Card
Aşağıda eklenti kartı örneği verilmiştir.
function createCard() { return CardService.newCardBuilder() .setHeader(CardService.newCardHeader().setTitle('CardTitle')) .build(); }
Dilerseniz birden fazla kartı aşağıdaki gibi iade edebilirsiniz:
function createCards() { return [ CardService.newCardBuilder().build(), CardService.newCardBuilder().build(), CardService.newCardBuilder().build(), ]; }
Aşağıda, başlık, metin, resim ve menü öğesi içeren bir kartı nasıl tanımlayabileceğiniz gösterilmektedir:
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(); }
Chat uygulamaları kartı örneği.
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();
Özellikler
| Mülk | Tür | Açıklama |
|---|---|---|
Border | Border | Border numaralandırması. |
Chip | Chip | Chip numaralandırması. |
Composed | Composed | Composed numaralandırması. |
Content | Content | Content numaralandırması. |
Grid | Grid | Grid numaralandırması. |
Horizontal | Horizontal | Horizontal numaralandırması. |
Icon | Icon | Icon numaralandırması. |
Image | Image | Image numaralandırması. |
Image | Image | Image numaralandırması. |
Image | Image | Image numaralandırması. |
Input | Input | Input numaralandırması. |
Load | Load | Load numaralandırması. |
On | On | On numaralandırması. |
Open | Open | Open numaralandırması. |
Selection | Selection | Selection numaralandırması. |
Text | Text | Text numaralandırması. |
Update | Update | Update numaralandırması. |
Yöntemler
Ayrıntılı dokümanlar
new Action Response Builder()
Yeni bir Action oluşturur.
Return
Action: Boş bir ActionResponse oluşturucu.
new Action Status()
Yeni bir Action oluşturur.
Yalnızca Google Chat uygulamaları için kullanılabilir. Google Workspace eklentilerinde kullanılamaz.
const actionStatus = CardService.newActionStatus() .setStatusCode(CardService.Status.OK) .setUserFacingMessage('Success');
Return
Action: Boş bir ActionStatus.
new Attachment()
new Authorization Action()
new Authorization Exception()
Yeni bir Authorization oluşturur.
Return
Authorization: Boş bir AuthorizationException.
new Border Style()
new Calendar Event Action Response Builder()
Yeni bir Calendar oluşturur.
Return
Calendar: Boş bir Calendar.
new Card Action()
new Card Builder()
new Card Header()
new Card Section()
new Card With Id()
Yeni bir Card oluşturur. Bu, Google Chat mesajında kart göndermek için kullanılır. Kart kimliği, birden fazla kart gönderilirken mesajdaki kartın benzersiz tanımlayıcısıdır.
Yalnızca Google Chat uygulamaları için kullanılabilir. Google Workspace eklentilerinde kullanılamaz.
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);
Return
Card: Boş bir Card.
new Carousel()
Bir Carousel oluşturur.
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')))
Return
Carousel: Boş bir bant.
new Carousel Card()
Yeni bir Carousel oluşturur.
const carouselCard = CardService.newCarouselCard().addWidget( CardService.newTextParagraph().setText('Text paragraph in carousel'));
Return
Carousel: Boş çip.
new Chat Action Response()
Yeni bir Chat oluşturur.
Yalnızca Google Chat uygulamaları için kullanılabilir. Google Workspace eklentilerinde kullanılamaz.
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);
Return
Chat: Boş bir Chat.
new Chat Response Builder()
Yeni bir Chat oluşturur.
Yalnızca Google Chat uygulamaları için kullanılabilir. Google Workspace eklentilerinde kullanılamaz.
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();
Return
Chat: Boş bir ChatResponseBuilder.
new Chip()
new Chip List()
Yeni bir Chip oluşturur.
Google Chat uygulamaları için kullanılabilir. Google Workspace eklentileri için geliştirici önizlemesinde.
const chip = CardService.newChip(); // Finish building the text chip... const chipList = CardService.newChipList() .setLayout(CardService.ChipListLayout.WRAPPED) .addChip(chip);
Return
Chip: Boş bir ChipList.
new Collapse Control()
Yeni bir Collapse oluşturur.
Google Chat uygulamaları için kullanılabilir. Google Workspace eklentileri için geliştirici önizlemesinde.
const collapseControl = CardService.newCollapseControl() .setHorizontalAlign(CardService.HorizontalAlignment.START) .setExpandButton(CardService.newTextButton().setText('Expand')) .setCollapseButton(CardService.newTextButton().setText('Collapse'));
Return
Collapse: Boş bir CollapseControl.
new Column()
Yeni bir Column oluşturur.
Google Chat uygulamaları ve Google Workspace eklentilerinde kullanılabilir.
const columnWidget = CardService.newTextParagraph(); const column = CardService.newColumn() .setHorizontalSizeStyle( CardService.HorizontalSizeStyle.FILL_AVAILABLE_SPACE) .setHorizontalAlignment(CardService.HorizontalAlignment.CENTER) .setVerticalAlignment(CardService.VerticalAlignment.CENTER) .addWidget(columnWidget);
Return
Column: Boş bir sütun.
new Columns()
Yeni bir Columns grubu oluşturur.
Google Chat uygulamaları ve Google Workspace eklentilerinde kullanılabilir.
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);
Return
Columns: Boş bir sütun grubu.
new Compose Action Response Builder()
Yeni bir Compose oluşturur.
Return
Compose: Boş bir ComposeActionResponse oluşturucu.
new Date Picker()
new Date Time Picker()
new Decorated Text()
new Dialog()
Yeni bir Dialog oluşturur.
Yalnızca Google Chat uygulamaları için kullanılabilir. Google Workspace eklentilerinde kullanılamaz.
const card = CardService.newCardBuilder() .setHeader(CardService.newCardHeader().setTitle('Card title')) .build(); // Sets the card of the dialog. const dialog = CardService.newDialog().setBody(card);
Return
new Dialog Action()
Yeni bir Dialog oluşturur.
Yalnızca Google Chat uygulamaları için kullanılabilir. Google Workspace eklentilerinde kullanılamaz.
const card = CardService.newCardBuilder() .setHeader(CardService.newCardHeader().setTitle('Card title')) .build(); const dialog = CardService.newDialog().setBody(card); const dialogAction = CardService.newDialogAction().setDialog(dialog);
Return
Dialog: Boş bir Dialog.
new Divider()
Yeni bir Divider oluşturur. Aşağıdaki örnekte, bir ayırıcıyla ayrılmış 2 paragraf içeren basit bir kart oluşturulmaktadır.
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; }
Return
Divider: Bölücü.
new Drive Items Selected Action Response Builder()
Yeni bir Drive oluşturur.
Return
Drive: Boş bir Drive.
new Editor File Scope Action Response Builder()
Yeni bir Editor oluşturur.
Return
Editor: Boş bir Editor.
new Image Button()
new Image Component()
new Image Crop Style()
new Link Preview()
Yeni bir Link oluşturur.
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');
Return
Link: Boş bir LinkPreview.
new Material Icon()
Yeni bir Material oluşturur.
Google Chat uygulamaları ve Google Workspace eklentilerinde kullanılabilir.
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();
Return
Material: Boş bir MaterialIcon.
new Notification()
new Overflow Menu()
Yeni bir Overflow oluşturur.
Google Chat uygulamaları için kullanılabilir. Google Workspace eklentileri için geliştirici önizlemesinde.
const overflowMenuItem = CardService.newOverflowMenuItem(); // Finish building the overflow menu item... const overflowMenu = CardService.newOverflowMenu().addMenuItem(overflowMenuItem);
Return
Overflow: Boş bir OverflowMenu.
new Overflow Menu Item()
Yeni bir Overflow oluşturur.
Google Chat uygulamaları için kullanılabilir. Google Workspace eklentileri için geliştirici önizlemesinde.
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'));
Return
Overflow: Boş bir OverflowMenuItem.
new Selection Input()
new Suggestions()
new Suggestions Response Builder()
Yeni bir Suggestions oluşturur.
Return
Suggestions: Boş bir SuggestionsResponse oluşturucu.
new Text Button()
new Text Paragraph()
new Time Picker()
new Universal Action Response Builder()
Yeni bir Universal oluşturur.
Return
Universal: Boş bir UniversalActionResponse oluşturucu.
new Update Draft Action Response Builder()
Yeni bir Update oluşturur.
Return
Update: Boş bir UpdateDraftActionResponseBuilder.
new Update Draft Bcc Recipients Action()
Yeni bir Update oluşturur;
Return
Update: Boş bir UpdateDraftBccRecipientsAction.
new Update Draft Body Action()
Yeni bir Update oluşturur.
Return
Update: Boş bir UpdateDraftBodyAction.
new Update Draft Cc Recipients Action()
Yeni bir Update oluşturur.
Return
Update: Boş bir UpdateDraftCcRecipientsAction.
new Update Draft Subject Action()
Yeni bir Update oluşturur.
Return
Update: Boş bir UpdateDraftSubjectAction.
new Update Draft To Recipients Action()
Yeni bir Update oluşturur.
Return
Update: Boş bir UpdateDraftToRecipientsAction.
new Validation()
Yeni bir Validation oluşturur.
Google Chat uygulamaları ve Google Workspace eklentilerinde kullanılabilir.
const validation = CardService.newValidation().setCharacterLimit(5).setInputType( CardService.InputType.EMAIL);
Return
Validation: Boş bir doğrulama.