توفّر 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 |
الطُرق
مستندات تفصيلية
new Action Response Builder()
لإنشاء Action
جديد.
الإرجاع
Action
- أداة إنشاء فارغة لعنصر ActionResponse
new Action Status()
لإنشاء Action
جديد
لا تتوفّر هذه الميزة إلا لتطبيقات Google Chat. لا تتوفّر الإضافات في Google Workspace.
const actionStatus = CardService.newActionStatus() .setStatusCode(CardService.Status.OK) .setUserFacingMessage('Success');
الإرجاع
Action
: حالة إجراء فارغة
new Attachment()
new Authorization Action()
new Authorization Exception()
لإنشاء Authorization
جديد
الإرجاع
Authorization
— عنصر AuthorizationException فارغ.
new Border Style()
new Calendar Event Action Response Builder()
لإنشاء Calendar
جديد.
الإرجاع
Calendar
: Calendar
فارغ
new Card Action()
new Card Builder()
new Card Header()
new Card Section()
new Card With Id()
لإنشاء 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
فارغ
new Chat Action Response()
لإنشاء 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);
الإرجاع
new Chat Response Builder()
لإنشاء 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 فارغ.
new Chip()
new Chip List()
لإنشاء 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
: قائمة شرائح فارغة
new Collapse Control()
لإنشاء 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 فارغ.
new Column()
لإنشاء 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
: عمود فارغ
new Columns()
لإنشاء مجموعة جديدة من 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
: مجموعة فارغة من الأعمدة
new Compose Action Response Builder()
لإنشاء Compose
جديد
الإرجاع
Compose
: أداة إنشاء فارغة لعنصر ComposeActionResponse
new Date Picker()
new Date Time Picker()
new Decorated Text()
new Dialog()
لإنشاء 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);
الإرجاع
new Dialog Action()
لإنشاء 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
فارغ
new Divider()
لإنشاء 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
: فاصل
new Drive Items Selected Action Response Builder()
new Editor File Scope Action Response Builder()
لإنشاء Editor
جديد
الإرجاع
Editor
: Editor
فارغ
new Image Button()
new Image Component()
new Image Crop Style()
new Link Preview()
لإنشاء 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 فارغ.
new Material Icon()
لإنشاء 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 فارغ
new Notification()
new Overflow Menu()
لإنشاء Overflow
جديد
تتوفّر هذه الميزة لتطبيقات Google Chat. في الإصدار التجريبي للمطوّرين لإضافات Google Workspace
const overflowMenuItem = CardService.newOverflowMenuItem(); // Finish building the overflow menu item... const overflowMenu = CardService.newOverflowMenu().addMenuItem(overflowMenuItem);
الإرجاع
Overflow
: قائمة كاملة فارغة
new Overflow Menu Item()
لإنشاء 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 فارغ.
new Selection Input()
new Suggestions()
new Suggestions Response Builder()
لإنشاء Suggestions
جديد
الإرجاع
Suggestions
: أداة إنشاء فارغة لـ SuggestionsResponse
new Text Button()
new Text Paragraph()
new Time Picker()
new Universal Action Response Builder()
لإنشاء Universal
جديد
الإرجاع
Universal
- أداة إنشاء فارغة لعنصر UniversalActionResponse
new Update Draft Action Response Builder()
لإنشاء Update
جديد
الإرجاع
Update
- عنصر UpdateDraftActionResponseBuilder فارغ.
new Update Draft Bcc Recipients Action()
إنشاء Update
جديد
الإرجاع
Update
- عنصر UpdateDraftBccRecipientsAction فارغ.
new Update Draft Body Action()
new Update Draft Cc Recipients Action()
لإنشاء Update
جديد
الإرجاع
Update
— عنصر UpdateDraftCcRecipientsAction فارغ.
new Update Draft Subject Action()
لإنشاء Update
جديد
الإرجاع
Update
: عنصر UpdateDraftSubjectAction فارغ.
new Update Draft To Recipients Action()
لإنشاء Update
جديد.
الإرجاع
Update
: عنصر UpdateDraftToRecipientsAction فارغ.
new Validation()
لإنشاء Validation
جديد.
تتوفّر هذه الميزة لتطبيقات Google Chat وإضافات Google Workspace.
const validation = CardService.newValidation().setCharacterLimit(5).setInputType( CardService.InputType.EMAIL);
الإرجاع
Validation
- عملية تحقق فارغة.