CardService, Google Workspace Eklentileri gibi farklı Google genişletilebilirlik ürünlerinde kullanılan genel kartlar oluşturma olanağı sunar.
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 |
---|---|---|
BorderType | BorderType | BorderType numaralandırması. |
ChipListLayout | ChipListLayout | ChipListLayout numaralandırması. |
ComposedEmailType | ComposedEmailType | ComposedEmailType numaralandırması. |
ContentType | ContentType | ContentType numaralandırması. |
GridItemLayout | GridItemLayout | GridItemLayout numaralandırması. |
HorizontalAlignment | HorizontalAlignment | HorizontalAlignment numaralandırması. |
Icon | Icon | Icon numaralandırması. |
ImageButtonStyle | ImageButtonStyle | ImageButtonStyle numaralandırması. |
ImageCropType | ImageCropType | ImageCropType numaralandırması. |
ImageStyle | ImageStyle | ImageStyle numaralandırması. |
InputType | InputType | InputType numaralandırması. |
LoadIndicator | LoadIndicator | LoadIndicator numaralandırması. |
OnClose | OnClose | OnClose numaralandırması. |
OpenAs | OpenAs | OpenAs numaralandırması. |
SelectionInputType | SelectionInputType | SelectionInputType numaralandırması. |
TextButtonStyle | TextButtonStyle | TextButtonStyle numaralandırması. |
UpdateDraftBodyType | UpdateDraftBodyType | UpdateDraftBodyType numaralandırması. |
Yöntemler
Ayrıntılı dokümanlar
newActionResponseBuilder()
Yeni bir ActionResponseBuilder
oluşturur.
Return
ActionResponseBuilder
: Boş bir ActionResponse oluşturucu.
newActionStatus()
Yeni bir ActionStatus
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
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. 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
CardWithId
: Boş bir CardWithId
.
newChatActionResponse()
Yeni bir ChatActionResponse
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
ChatActionResponse
: Boş bir ChatActionResponse
.
newChatResponseBuilder()
Yeni bir ChatResponseBuilder
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
ChatResponseBuilder
: Boş bir ChatResponseBuilder.
newChip()
newChipList()
Yeni bir ChipList
oluşturur.
Yalnızca Google Chat uygulamaları için kullanılabilir. Google Workspace eklentileri için kullanılamaz.
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.
Yalnızca Google Chat uygulamaları için kullanılabilir. Google Workspace eklentileri için kullanılamaz.
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 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.
newColumns()
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.
newComposeActionResponseBuilder()
Yeni bir ComposeActionResponseBuilder
oluşturur.
Return
ComposeActionResponseBuilder
: Boş bir ComposeActionResponse oluşturucu.
newDatePicker()
newDateTimePicker()
newDecoratedText()
newDialog()
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
newDialogAction()
Yeni bir DialogAction
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
DialogAction
: Boş bir DialogAction
.
newDivider()
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ü.
newDriveItemsSelectedActionResponseBuilder()
Yeni bir DriveItemsSelectedActionResponseBuilder
oluşturur.
Return
DriveItemsSelectedActionResponseBuilder
: Boş bir DriveItemsSelectedActionResponseBuilder
.
newEditorFileScopeActionResponseBuilder()
Yeni bir EditorFileScopeActionResponseBuilder
oluşturur.
Return
EditorFileScopeActionResponseBuilder
: Boş bir EditorFileScopeActionResponseBuilder
.
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(); const linkPreview = 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 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
MaterialIcon
: Boş bir MaterialIcon.
newNotification()
newOverflowMenu()
Yeni bir OverflowMenu
oluşturur.
Yalnızca Google Chat uygulamaları için kullanılabilir. Google Workspace eklentileri için kullanılamaz.
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.
Yalnızca Google Chat uygulamaları için kullanılabilir. Google Workspace eklentileri için kullanılamaz.
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.
newSelectionInput()
newSuggestions()
newSuggestionsResponseBuilder()
Yeni bir SuggestionsResponseBuilder
oluşturur.
Return
SuggestionsResponseBuilder
: Boş bir SuggestionsResponse oluşturucu.
newTextButton()
newTextParagraph()
newTimePicker()
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.
newValidation()
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.