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ı şu şekilde de 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 eklentileri için 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 eklentileri için 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 Chat Action Response()
Yeni bir Chat
oluşturur.
Yalnızca Google Chat uygulamaları için kullanılabilir. Google Workspace eklentileri için 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 eklentileri için 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 eklentileri için 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 eklentileri için 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.