CardService, farklı Google ürünlerinde kullanılan genel kartlar oluşturmanıza olanak tanır. Google Workspace Eklentileri gibi genişletilebilirlik ürünleri.
Aşağıda eklenti kartı örneği verilmiştir.
return CardService.newCardBuilder() .setHeader(CardService.newCardHeader().setTitle("CardTitle")) .build();
İsterseniz birden fazla kartı şu şekilde iade edebilirsiniz:
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
Özellik | Tür | Açıklama |
---|---|---|
BorderType | BorderType | BorderType 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ı. |
ImageCropType | ImageCropType | ImageCropType numaralandırması. |
ImageStyle | ImageStyle | ImageStyle 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ı 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 eklentileriyle 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 mesajlarında kart göndermek için kullanılır. kart kimliği
birden fazla kart gönderilirken mesajdaki bir kartın benzersiz tanımlayıcısıdır.
Yalnızca Google Chat uygulamalarında kullanılabilir. Google Workspace eklentileriyle 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ında kullanılabilir. Google Workspace eklentileriyle 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 eklentileriyle 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.
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);
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(column) .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ında kullanılabilir. Google Workspace eklentileriyle 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 eklentileriyle 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 örnek 2 paragraflık basit bir kart oluşturur
ile ayrılır.
function buildCard() { let cardSection1TextParagraph1 = CardService.newTextParagraph() .setText('Hello world!'); let cardSection1Divider1 = CardService.newDivider(); let cardSection1TextParagraph2 = CardService.newTextParagraph() .setText('Hello world!'); let cardSection1 = CardService.newCardSection() .addWidget(cardSection1TextParagraph1) .addWidget(cardSection1Divider1) .addWidget(cardSection1TextParagraph2); let card = CardService.newCardBuilder() .addSection(cardSection1) .build(); return card; }
Return
Divider
— Ayırı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.
newNotification()
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 UpdateDraftDraftCcRecipientsAction.
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.