توفّر Card
في ما يلي نموذج لبطاقة الإضافات.
function createCard() { return CardService.newCardBuilder() .setHeader(CardService.newCardHeader().setTitle('CardTitle')) .build(); }
أو يمكنك عرض بطاقات متعددة على النحو التالي:
function createCards() { return [ CardService.newCardBuilder().build(), CardService.newCardBuilder().build(), CardService.newCardBuilder().build(), ]; }
يوضّح ما يلي كيفية تحديد بطاقة تتضمّن عنوانًا ونصًا وصورة وعنصر قائمة:
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"
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();
الخصائص
الموقع | النوع | الوصف |
---|---|---|
Border | Border | تعداد Border |
Chip | Chip | تعداد Chip |
Composed | Composed | تعداد Composed |
Content | Content | تعداد Content |
Grid | Grid | تعداد Grid |
Horizontal | Horizontal | تعداد Horizontal |
Icon | Icon | تعداد Icon |
Image | Image | تعداد Image |
Image | Image | تعداد Image |
Image | Image | تعداد Image |
Input | Input | تعداد Input |
Load | Load | تعداد Load |
On | On | تعداد On |
Open | Open | تعداد Open |
Selection | Selection | تعداد Selection |
Text | Text | تعداد Text |
Update | Update | تعداد Update |
الطُرق
مستندات تفصيلية
newActionResponseBuilder()
لإنشاء Action
جديد
الإرجاع
Action
- أداة إنشاء فارغة لعنصر ActionResponse
newActionStatus()
لإنشاء Action
جديد
لا تتوفّر هذه الميزة إلا لتطبيقات Google Chat. لا تتوفّر الإضافات في Google Workspace.
const actionStatus = CardService.newActionStatus() .setStatusCode(CardService.Status.OK) .setUserFacingMessage('Success');
الإرجاع
Action
: حالة إجراء فارغة
newAttachment()
newAuthorizationAction()
newAuthorizationException()
لإنشاء Authorization
جديد
الإرجاع
Authorization
— عنصر AuthorizationException فارغ.
newBorderStyle()
newCalendarEventActionResponseBuilder()
لإنشاء Calendar
جديد
الإرجاع
Calendar
: Calendar
فارغ
newCardAction()
newCardBuilder()
newCardHeader()
newCardSection()
newCardWithId()
لإنشاء Card
جديد يُستخدَم هذا الحقل لإرسال بطاقة في رسالة على Google Chat. معرّف البطاقة
هو معرّف فريد لبطاقة في رسالة عند إرسال بطاقات متعددة.
لا تتوفّر هذه الميزة إلا لتطبيقات Google Chat. لا تتوفّر الإضافات في Google Workspace.
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);
الإرجاع
Card
: Card
فارغ
newCarousel()
لإنشاء Carousel
.
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')))
الإرجاع
Carousel
- لوحة عرض دوّارة فارغة
newCarouselCard()
لإنشاء Carousel
جديد
const carouselCard = CardService.newCarouselCard().addWidget( CardService.newTextParagraph().setText('Text paragraph in carousel'));
الإرجاع
Carousel
: شريحة فارغة
newChatActionResponse()
لإنشاء Chat
جديد
لا تتوفّر هذه الميزة إلا لتطبيقات Google Chat. لا تتوفّر الإضافات في Google Workspace.
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);
الإرجاع
newChatResponseBuilder()
لإنشاء Chat
جديد
لا تتوفّر هذه الميزة إلا لتطبيقات Google Chat. لا تتوفّر الإضافات في Google Workspace.
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();
الإرجاع
Chat
- عنصر ChatResponseBuilder فارغ.
newChip()
newChipList()
لإنشاء Chip
جديد
تتوفّر هذه الميزة لتطبيقات Google Chat. في الإصدار التجريبي المخصّص للمطوّرين لإضافات Google Workspace
const chip = CardService.newChip(); // Finish building the text chip... const chipList = CardService.newChipList() .setLayout(CardService.ChipListLayout.WRAPPED) .addChip(chip);
الإرجاع
Chip
: قائمة شرائح فارغة
newCollapseControl()
لإنشاء Collapse
جديد
تتوفّر هذه الميزة لتطبيقات Google Chat. في الإصدار التجريبي المخصّص للمطوّرين لإضافات Google Workspace
const collapseControl = CardService.newCollapseControl() .setHorizontalAlign(CardService.HorizontalAlignment.START) .setExpandButton(CardService.newTextButton().setText('Expand')) .setCollapseButton(CardService.newTextButton().setText('Collapse'));
الإرجاع
Collapse
: عنصر CollapseControl فارغ.
newColumn()
لإنشاء Column
جديد
تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.
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
: عمود فارغ
newColumns()
لإنشاء مجموعة جديدة من Columns
.
تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.
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);
الإرجاع
Columns
: مجموعة فارغة من الأعمدة
newComposeActionResponseBuilder()
لإنشاء Compose
جديد
الإرجاع
Compose
- أداة إنشاء فارغة لعنصر ComposeActionResponse
newDatePicker()
newDateTimePicker()
newDecoratedText()
newDialog()
لإنشاء Dialog
جديد
لا تتوفّر هذه الميزة إلا لتطبيقات Google Chat. لا تتوفّر الإضافات في Google Workspace.
const card = CardService.newCardBuilder() .setHeader(CardService.newCardHeader().setTitle('Card title')) .build(); // Sets the card of the dialog. const dialog = CardService.newDialog().setBody(card);
الإرجاع
newDialogAction()
لإنشاء Dialog
جديد
لا تتوفّر هذه الميزة إلا لتطبيقات Google Chat. لا تتوفّر الإضافات في Google Workspace.
const card = CardService.newCardBuilder() .setHeader(CardService.newCardHeader().setTitle('Card title')) .build(); const dialog = CardService.newDialog().setBody(card); const dialogAction = CardService.newDialogAction().setDialog(dialog);
الإرجاع
Dialog
: Dialog
فارغ
newDivider()
لإنشاء Divider
جديد ينشئ العيّنة التالية بطاقة بسيطة تتضمّن فقرتَين
مفصوفتَين بفاصل.
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; }
الإرجاع
Divider
: فاصل
newDriveItemsSelectedActionResponseBuilder()
newEditorFileScopeActionResponseBuilder()
لإنشاء Editor
جديد
الإرجاع
Editor
: Editor
فارغ
newImageButton()
newImageComponent()
newImageCropStyle()
newLinkPreview()
لإنشاء Link
جديد
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');
الإرجاع
Link
: عنصر LinkPreview فارغ.
newMaterialIcon()
لإنشاء Material
جديد
تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.
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();
الإرجاع
Material
: رمز MaterialIcon فارغ
newNotification()
newOverflowMenu()
لإنشاء Overflow
جديد
تتوفّر هذه الميزة لتطبيقات Google Chat. في الإصدار التجريبي المخصّص للمطوّرين لإضافات Google Workspace
const overflowMenuItem = CardService.newOverflowMenuItem(); // Finish building the overflow menu item... const overflowMenu = CardService.newOverflowMenu().addMenuItem(overflowMenuItem);
الإرجاع
Overflow
- OverflowMenu فارغة
newOverflowMenuItem()
لإنشاء Overflow
جديد
تتوفّر هذه الميزة لتطبيقات Google Chat. في الإصدار التجريبي المخصّص للمطوّرين لإضافات Google Workspace
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'));
الإرجاع
Overflow
: عنصر OverflowMenuItem فارغ.
newSelectionInput()
newSuggestions()
newSuggestionsResponseBuilder()
لإنشاء Suggestions
جديد
الإرجاع
Suggestions
: أداة إنشاء فارغة لـ SuggestionsResponse
newTextButton()
newTextParagraph()
newTimePicker()
newUniversalActionResponseBuilder()
لإنشاء Universal
جديد
الإرجاع
Universal
- أداة إنشاء فارغة لعنصر UniversalActionResponse
newUpdateDraftActionResponseBuilder()
لإنشاء Update
جديد
الإرجاع
Update
- عنصر UpdateDraftActionResponseBuilder فارغ.
newUpdateDraftBccRecipientsAction()
إنشاء Update
جديد
الإرجاع
Update
- عنصر UpdateDraftBccRecipientsAction فارغ.
newUpdateDraftBodyAction()
newUpdateDraftCcRecipientsAction()
لإنشاء Update
جديد
الإرجاع
Update
— عنصر UpdateDraftCcRecipientsAction فارغ.
newUpdateDraftSubjectAction()
لإنشاء Update
جديد
الإرجاع
Update
: عنصر UpdateDraftSubjectAction فارغ
newUpdateDraftToRecipientsAction()
لإنشاء Update
جديد
الإرجاع
Update
: عنصر UpdateDraftToRecipientsAction فارغ.
newValidation()
لإنشاء Validation
جديد
تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.
const validation = CardService.newValidation().setCharacterLimit(5).setInputType( CardService.InputType.EMAIL);
الإرجاع
Validation
- عملية تحقق فارغة.