CardService, Google Workspace eklentileri gibi farklı Google genişletilebilirlik ürünlerinde kullanılan genel kartlar oluşturma olanağı sağlar.
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ın nasıl tanımlanabileceği 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ı. |
Common | Common | Common numaralandırması. |
Composed | Composed | Composed numaralandırması. |
Content | Content | Content numaralandırması. |
Drive | Drive | Drive numaralandırması. |
Expression | Expression | Expression numaralandırması. |
Expression | Expression | Expression 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ı. |
Text | Text | Text numaralandırması. |
Update | Update | Update numaralandırması. |
Variable | Variable | Variable numaralandırması. |
Visibility | Visibility | Visibility numaralandırması. |
Workflow | Workflow | Workflow numaralandırması. |
Yöntemler
Ayrıntılı belgeler
newActionResponseBuilder()
Yeni bir ActionResponseBuilder oluşturur.
Return
ActionResponseBuilder: Boş bir ActionResponse oluşturucu.
newActionStatus()
Yeni bir ActionStatus oluşturur.
Yalnızca Google Chat uygulamalarında kullanılabilir. Google Workspace eklentileri için kullanılamaz.
const actionStatus = CardService.newActionStatus() .setStatusCode(CardService.Status.OK) .setUserFacingMessage('Success');
Return
ActionStatus: Boş bir ActionStatus.
newAttachment()
newAuthorizationAction()
newAuthorizationException()
Yeni bir AuthorizationException oluşturur.
Return
AuthorizationException — Boş bir AuthorizationException.
newBorderStyle()
newCalendarEventActionResponseBuilder()
Yeni bir CalendarEventActionResponseBuilder oluşturur.
Return
CalendarEventActionResponseBuilder: Boş bir CalendarEventActionResponseBuilder.
newCardAction()
newCardBuilder()
newCardHeader()
newCardSection()
newCardWithId()
Yeni bir CardWithId oluşturur. Bu, Google Chat mesajında kart göndermek için kullanılır. card ID<0x0A>, birden fazla kart gönderirken iletideki kart için benzersiz bir tanımlayıcıdır.
Yalnızca Google Chat uygulamalarında 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
CardWithId: Boş bir CardWithId.
newCarousel()
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.
newCarouselCard()
Yeni bir CarouselCard oluşturur.
const carouselCard = CardService.newCarouselCard().addWidget( CardService.newTextParagraph().setText('Text paragraph in carousel'));
Return
CarouselCard: Boş bir çip.
newChatActionResponse()
Yeni bir ChatActionResponse oluşturur.
Yalnızca Google Chat uygulamalarında 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
ChatActionResponse: Boş bir ChatActionResponse.
newChatResponseBuilder()
Yeni bir ChatResponseBuilder oluşturur.
Yalnızca Google Chat uygulamalarında 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
ChatResponseBuilder: Boş bir ChatResponseBuilder.
newChip()
newChipList()
Yeni bir ChipList oluşturur.
Google Chat uygulamalarında 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
ChipList: Boş bir ChipList.
newCollapseControl()
Yeni bir CollapseControl oluşturur.
Google Chat uygulamalarında 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
CollapseControl: Boş bir CollapseControl.
newColumn()
Yeni bir Column oluşturur.
Google Chat uygulamaları ve Google Workspace eklentileri için 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.
newColumns()
Yeni bir Columns grubu oluşturur.
Google Chat uygulamaları ve Google Workspace eklentileri için 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 kümesi.
newCommonWidgetAction()
newComposeActionResponseBuilder()
Yeni bir ComposeActionResponseBuilder oluşturur.
Return
ComposeActionResponseBuilder: Boş bir ComposeActionResponse oluşturucu.
newCondition()
newDataSourceConfig()
newDatePicker()
newDateTimePicker()
newDecoratedText()
newDialog()
Yeni bir Dialog oluşturur.
Yalnızca Google Chat uygulamalarında 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
newDialogAction()
Yeni bir DialogAction oluşturur.
Yalnızca Google Chat uygulamalarında 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
DialogAction: Boş bir DialogAction.
newDivider()
Yeni bir Divider oluşturur. Aşağıdaki örnekte, ayraçla ayrılmış 2 paragraftan oluşan 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: Ayırıcı.
newDriveDataSourceSpec()
newDriveItemsSelectedActionResponseBuilder()
Yeni bir DriveItemsSelectedActionResponseBuilder oluşturur.
Return
DriveItemsSelectedActionResponseBuilder: Boş bir DriveItemsSelectedActionResponseBuilder.
newEditorFileScopeActionResponseBuilder()
Yeni bir EditorFileScopeActionResponseBuilder oluşturur.
Return
EditorFileScopeActionResponseBuilder: Boş bir EditorFileScopeActionResponseBuilder.
newEventAction()
İstemci tarafı doğrulama için kullanılan yeni bir EventAction oluşturur.
Return
EventAction: Boş bir EventAction.
newExpressionData()
İstemci tarafı doğrulama için kullanılan yeni bir ExpressionData oluşturur.
Return
ExpressionData: Boş bir ExpressionData.
newExpressionDataAction()
İstemci tarafı doğrulama için kullanılan yeni bir ExpressionDataAction oluşturur.
Return
ExpressionDataAction: Boş bir ExpressionDataAction.
newExpressionDataCondition()
İstemci tarafı doğrulama için kullanılan yeni bir ExpressionDataCondition oluşturur.
Return
newHostAppDataSource()
newImageButton()
newImageComponent()
newImageCropStyle()
newLinkPreview()
Yeni bir LinkPreview oluşturur.
const decoratedText = CardService.newDecoratedText().setTopLabel('Hello').setText('Hi!'); const cardSection = CardService.newCardSection().addWidget(decoratedText); const card = CardService.newCardBuilder().addSection(cardSection).build(); return CardService.newLinkPreview().setPreviewCard(card).setTitle( 'Smart chip title');
Return
LinkPreview: Boş bir LinkPreview.
newMaterialIcon()
Yeni bir MaterialIcon oluşturur.
Google Chat uygulamaları ve Google Workspace eklentileri için 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
MaterialIcon: Boş bir MaterialIcon.
newNotification()
newOverflowMenu()
Yeni bir OverflowMenu oluşturur.
Google Chat uygulamalarında 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
OverflowMenu: Boş bir OverflowMenu.
newOverflowMenuItem()
Yeni bir OverflowMenuItem oluşturur.
Google Chat uygulamalarında 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
OverflowMenuItem: Boş bir OverflowMenuItem.
newPlatformDataSource()
newSelectionInput()
newSuggestions()
newSuggestionsResponseBuilder()
Yeni bir SuggestionsResponseBuilder oluşturur.
Return
SuggestionsResponseBuilder: Boş bir SuggestionsResponse oluşturucu.
newTextButton()
newTextParagraph()
newTimePicker()
newTrigger()
newUniversalActionResponseBuilder()
Yeni bir UniversalActionResponseBuilder oluşturur.
Return
UniversalActionResponseBuilder: Boş bir UniversalActionResponse oluşturucu.
newUpdateDraftActionResponseBuilder()
Yeni bir UpdateDraftActionResponseBuilder oluşturur.
Return
UpdateDraftActionResponseBuilder: Boş bir UpdateDraftActionResponseBuilder.
newUpdateDraftBccRecipientsAction()
Yeni bir UpdateDraftBccRecipientsAction oluşturur;
Return
UpdateDraftBccRecipientsAction: Boş bir UpdateDraftBccRecipientsAction.
newUpdateDraftBodyAction()
Yeni bir UpdateDraftBodyAction oluşturur.
Return
UpdateDraftBodyAction: Boş bir UpdateDraftBodyAction.
newUpdateDraftCcRecipientsAction()
Yeni bir UpdateDraftCcRecipientsAction oluşturur.
Return
UpdateDraftCcRecipientsAction: Boş bir UpdateDraftCcRecipientsAction.
newUpdateDraftSubjectAction()
Yeni bir UpdateDraftSubjectAction oluşturur.
Return
UpdateDraftSubjectAction: Boş bir UpdateDraftSubjectAction.
newUpdateDraftToRecipientsAction()
Yeni bir UpdateDraftToRecipientsAction oluşturur.
Return
UpdateDraftToRecipientsAction: Boş bir UpdateDraftToRecipientsAction.
newUpdateVisibilityAction()
Yeni bir UpdateVisibilityAction oluşturur.
Return
UpdateVisibilityAction: Boş bir UpdateVisibilityAction.
newValidation()
Yeni bir Validation oluşturur.
Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.
const validation = CardService.newValidation().setCharacterLimit(5).setInputType( CardService.InputType.EMAIL);
Return
Validation — Boş doğrulama.