توفّر 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 Carousel()
لإنشاء 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 - لوحة عرض دوّارة فارغة
new Carousel Card()
لإنشاء Carousel جديد
const carouselCard = CardService.newCarouselCard().addWidget( CardService.newTextParagraph().setText('Text paragraph in carousel'));
الإرجاع
Carousel: شريحة فارغة
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 - OverflowMenu فارغة
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 - عملية تحقق فارغة.