Class CardService

توفّر خدمة Card إمكانية إنشاء بطاقات عامة يمكن استخدامها في مختلف منتجات Google التي تتيح إمكانية التوسيع، مثل إضافات Google Workspace.

في ما يلي نموذج لبطاقة إضافات.

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();

الخصائص

الموقع	النوع	الوصف
`BorderType`	`BorderType`	تعداد `BorderType`
`ChipListLayout`	`ChipListLayout`	تعداد `ChipListLayout`
`CommonDataSource`	`CommonDataSource`	تعداد `CommonDataSource`
`ComposedEmailType`	`ComposedEmailType`	تعداد `ComposedEmailType`
`ContentType`	`ContentType`	تعداد `ContentType`
`DriveItemType`	`DriveItemType`	تعداد `DriveItemType`
`ExpressionDataActionType`	`ExpressionDataActionType`	تعداد `ExpressionDataActionType`
`ExpressionDataConditionType`	`ExpressionDataConditionType`	تعداد `ExpressionDataConditionType`
`GridItemLayout`	`GridItemLayout`	تعداد `GridItemLayout`
`HorizontalAlignment`	`HorizontalAlignment`	تعداد `HorizontalAlignment`
`Icon`	`Icon`	تعداد `Icon`
`ImageButtonStyle`	`ImageButtonStyle`	تعداد `ImageButtonStyle`
`ImageCropType`	`ImageCropType`	تعداد `ImageCropType`
`ImageStyle`	`ImageStyle`	تعداد `ImageStyle`
`InputType`	`InputType`	تعداد `InputType`
`LoadIndicator`	`LoadIndicator`	تعداد `LoadIndicator`
`OnClose`	`OnClose`	تعداد `OnClose`
`OpenAs`	`OpenAs`	تعداد `OpenAs`
`SelectionInputType`	`SelectionInputType`	تعداد `SelectionInputType`
`TextButtonStyle`	`TextButtonStyle`	تعداد `TextButtonStyle`
`TextInputMode`	`TextInputMode`	تعداد `TextInputMode`
`UpdateDraftBodyType`	`UpdateDraftBodyType`	تعداد `UpdateDraftBodyType`
`VariableButtonSize`	`VariableButtonSize`	تعداد `VariableButtonSize`
`Visibility`	`Visibility`	تعداد `Visibility`
`WorkflowDataSourceType`	`WorkflowDataSourceType`	تعداد `WorkflowDataSourceType`

الطُرق

الطريقة	نوع القيمة التي يتم إرجاعها	وصف قصير
`newAction()`	`Action`	تنشئ هذه الدالة `Action` جديدًا.
`newActionResponseBuilder()`	`ActionResponseBuilder`	تنشئ هذه الدالة `ActionResponseBuilder` جديدًا.
`newActionStatus()`	`ActionStatus`	تنشئ هذه الدالة `ActionStatus` جديدًا.
`newAttachment()`	`Attachment`	تنشئ هذه الدالة `Attachment` جديدًا.
`newAuthorizationAction()`	`AuthorizationAction`	تنشئ هذه الدالة `AuthorizationAction` جديدًا.
`newAuthorizationException()`	`AuthorizationException`	تنشئ هذه الدالة `AuthorizationException` جديدًا.
`newBorderStyle()`	`BorderStyle`	تنشئ هذه الدالة `BorderStyle` جديدًا.
`newButtonSet()`	`ButtonSet`	تنشئ هذه الدالة `ButtonSet` جديدًا.
`newCalendarEventActionResponseBuilder()`	`CalendarEventActionResponseBuilder`	تنشئ هذه الدالة `CalendarEventActionResponseBuilder` جديدًا.
`newCardAction()`	`CardAction`	تنشئ هذه الدالة `CardAction` جديدًا.
`newCardBuilder()`	`CardBuilder`	تنشئ هذه الطريقة أداة إنشاء بطاقات جديدة.
`newCardHeader()`	`CardHeader`	تنشئ هذه الدالة `CardHeader` جديدًا.
`newCardSection()`	`CardSection`	تنشئ هذه الدالة `CardSection` جديدًا.
`newCardWithId()`	`CardWithId`	تنشئ هذه الدالة `CardWithId` جديدًا.
`newCarousel()`	`Carousel`	تنشئ هذه الدالة `Carousel`.
`newCarouselCard()`	`CarouselCard`	تنشئ هذه الدالة `CarouselCard` جديدًا.
`newChatActionResponse()`	`ChatActionResponse`	تنشئ هذه الدالة `ChatActionResponse` جديدًا.
`newChatResponseBuilder()`	`ChatResponseBuilder`	تنشئ هذه الدالة `ChatResponseBuilder` جديدًا.
`newChip()`	`Chip`	تنشئ هذه الدالة `Chip` جديدًا.
`newChipList()`	`ChipList`	تنشئ هذه الدالة `ChipList` جديدًا.
`newCollapseControl()`	`CollapseControl`	تنشئ هذه الدالة `CollapseControl` جديدًا.
`newColumn()`	`Column`	تنشئ هذه الدالة `Column` جديدًا.
`newColumns()`	`Columns`	تنشئ هذه السمة مجموعة جديدة من `Columns`.
`newCommonWidgetAction()`	`CommonWidgetAction`	تنشئ هذه الدالة `CommonWidgetAction` جديدًا.
`newComposeActionResponseBuilder()`	`ComposeActionResponseBuilder`	تنشئ هذه الدالة `ComposeActionResponseBuilder` جديدًا.
`newCondition()`	`Condition`	تنشئ هذه السمة `Condition` جديدة تُستخدَم للتحقّق من صحة البيانات من جهة العميل.
`newDataSourceConfig()`	`DataSourceConfig`	تُنشئ هذه الطريقة `DataSourceConfig` فارغًا جديدًا.
`newDatePicker()`	`DatePicker`	تنشئ هذه الدالة `DatePicker` جديدًا.
`newDateTimePicker()`	`DateTimePicker`	تنشئ هذه الدالة `DateTimePicker` جديدًا.
`newDecoratedText()`	`DecoratedText`	تنشئ هذه الدالة `DecoratedText` جديدًا.
`newDialog()`	`Dialog`	تنشئ هذه الدالة `Dialog` جديدًا.
`newDialogAction()`	`DialogAction`	تنشئ هذه الدالة `DialogAction` جديدًا.
`newDivider()`	`Divider`	تنشئ هذه الدالة `Divider` جديدًا.
`newDriveDataSourceSpec()`	`DriveDataSourceSpec`	تنشئ هذه الدالة `DriveDataSourceSpec` جديدًا.
`newDriveItemsSelectedActionResponseBuilder()`	`DriveItemsSelectedActionResponseBuilder`	تنشئ هذه الدالة `DriveItemsSelectedActionResponseBuilder` جديدًا.
`newEditorFileScopeActionResponseBuilder()`	`EditorFileScopeActionResponseBuilder`	تنشئ هذه الدالة `EditorFileScopeActionResponseBuilder` جديدًا.
`newEventAction()`	`EventAction`	تنشئ هذه السمة `EventAction` جديدة تُستخدَم للتحقّق من صحة البيانات من جهة العميل.
`newExpressionData()`	`ExpressionData`	تنشئ هذه السمة `ExpressionData` جديدة تُستخدَم للتحقّق من صحة البيانات من جهة العميل.
`newExpressionDataAction()`	`ExpressionDataAction`	تنشئ هذه السمة `ExpressionDataAction` جديدة تُستخدَم للتحقّق من صحة البيانات من جهة العميل.
`newExpressionDataCondition()`	`ExpressionDataCondition`	تنشئ هذه السمة `ExpressionDataCondition` جديدة تُستخدَم للتحقّق من صحة البيانات من جهة العميل.
`newFixedFooter()`	`FixedFooter`	تنشئ هذه الدالة `FixedFooter` جديدًا.
`newGrid()`	`Grid`	تنشئ هذه الدالة `Grid` جديدًا.
`newGridItem()`	`GridItem`	تنشئ هذه الدالة `GridItem` جديدًا.
`newHostAppDataSource()`	`HostAppDataSource`	تنشئ هذه الدالة `HostAppDataSource` جديدًا.
`newIconImage()`	`IconImage`	تنشئ هذه الدالة `IconImage` جديدًا.
`newImage()`	`Image`	تنشئ هذه الدالة `Image` جديدًا.
`newImageButton()`	`ImageButton`	تنشئ هذه الدالة `ImageButton` جديدًا.
`newImageComponent()`	`ImageComponent`	تنشئ هذه الدالة `ImageComponent` جديدًا.
`newImageCropStyle()`	`ImageCropStyle`	تنشئ هذه الدالة `ImageCropStyle` جديدًا.
`newKeyValue()`	`KeyValue`	تنشئ هذه الدالة `KeyValue` جديدًا.
`newLinkPreview()`	`LinkPreview`	تنشئ هذه الدالة `LinkPreview` جديدًا.
`newMaterialIcon()`	`MaterialIcon`	تنشئ هذه الدالة `MaterialIcon` جديدًا.
`newNavigation()`	`Navigation`	تنشئ هذه الدالة `Navigation` جديدًا.
`newNotification()`	`Notification`	تنشئ هذه الدالة `Notification` جديدًا.
`newOpenLink()`	`OpenLink`	تنشئ هذه الدالة `OpenLink` جديدًا.
`newOverflowMenu()`	`OverflowMenu`	تنشئ هذه الدالة `OverflowMenu` جديدًا.
`newOverflowMenuItem()`	`OverflowMenuItem`	تنشئ هذه الدالة `OverflowMenuItem` جديدًا.
`newPlatformDataSource()`	`PlatformDataSource`	تنشئ هذه الدالة `PlatformDataSource` جديدًا.
`newSelectionInput()`	`SelectionInput`	تنشئ هذه الدالة `SelectionInput` جديدًا.
`newSuggestions()`	`Suggestions`	تنشئ هذه الدالة `Suggestions` جديدًا.
`newSuggestionsResponseBuilder()`	`SuggestionsResponseBuilder`	تنشئ هذه الدالة `SuggestionsResponseBuilder` جديدًا.
`newSwitch()`	`Switch`	تنشئ هذه الدالة `Switch` جديدًا.
`newTextButton()`	`TextButton`	تنشئ هذه الدالة `TextButton` جديدًا.
`newTextInput()`	`TextInput`	تنشئ هذه الدالة `TextInput` جديدًا.
`newTextParagraph()`	`TextParagraph`	تنشئ هذه الدالة `TextParagraph` جديدًا.
`newTimePicker()`	`TimePicker`	تنشئ هذه الدالة `TimePicker` جديدًا.
`newTrigger()`	`Trigger`	تنشئ هذه الدالة عنصر `Trigger` جديدًا وتُرجعه، ويُستخدم هذا العنصر للتحقّق من صحة البيانات من جهة العميل.
`newUniversalActionResponseBuilder()`	`UniversalActionResponseBuilder`	تنشئ هذه الدالة `UniversalActionResponseBuilder` جديدًا.
`newUpdateDraftActionResponseBuilder()`	`UpdateDraftActionResponseBuilder`	تنشئ هذه الدالة `UpdateDraftActionResponseBuilder` جديدًا.
`newUpdateDraftBccRecipientsAction()`	`UpdateDraftBccRecipientsAction`	تُنشئ هذه الطريقة `UpdateDraftBccRecipientsAction` جديدًا.
`newUpdateDraftBodyAction()`	`UpdateDraftBodyAction`	تنشئ هذه الدالة `UpdateDraftBodyAction` جديدًا.
`newUpdateDraftCcRecipientsAction()`	`UpdateDraftCcRecipientsAction`	تنشئ هذه الدالة `UpdateDraftCcRecipientsAction` جديدًا.
`newUpdateDraftSubjectAction()`	`UpdateDraftSubjectAction`	تنشئ هذه الدالة `UpdateDraftSubjectAction` جديدًا.
`newUpdateDraftToRecipientsAction()`	`UpdateDraftToRecipientsAction`	تنشئ هذه الدالة `UpdateDraftToRecipientsAction` جديدًا.
`newUpdateVisibilityAction()`	`UpdateVisibilityAction`	تنشئ هذه الدالة `UpdateVisibilityAction` جديدًا.
`newValidation()`	`Validation`	تنشئ هذه الدالة `Validation` جديدًا.
`newWorkflowDataSource()`	`WorkflowDataSource`	تنشئ هذه الدالة `WorkflowDataSource` جديدًا.

مستندات تفصيلية

`newAction()`

تنشئ هذه الدالة Action جديدًا.

الإرجاع

‫Action: إجراء فارغ

`newActionResponseBuilder()`

تنشئ هذه الدالة ActionResponseBuilder جديدًا.

الإرجاع

‫ActionResponseBuilder: أداة إنشاء ActionResponse فارغة.

`newActionStatus()`

تنشئ هذه الدالة ActionStatus جديدًا.

هذه الميزة متاحة فقط لتطبيقات Google Chat. لا تتوفّر لإضافات Google Workspace.

const actionStatus = CardService.newActionStatus()
                         .setStatusCode(CardService.Status.OK)
                         .setUserFacingMessage('Success');

الإرجاع

‫ActionStatus: تمثّل هذه القيمة ActionStatus فارغًا.

`newAttachment()`

تنشئ هذه الدالة Attachment جديدًا.

الإرجاع

‫Attachment: مرفق فارغ

`newAuthorizationAction()`

تنشئ هذه الدالة AuthorizationAction جديدًا.

الإرجاع

‫AuthorizationAction: تمثّل هذه السمة AuthorizationAction فارغة.

`newAuthorizationException()`

تنشئ هذه الدالة AuthorizationException جديدًا.

الإرجاع

AuthorizationException — An empty AuthorizationException.

`newBorderStyle()`

تنشئ هذه الدالة BorderStyle جديدًا.

الإرجاع

‫BorderStyle: يمثّل BorderStyle فارغًا.

`newButtonSet()`

تنشئ هذه الدالة ButtonSet جديدًا.

الإرجاع

‫ButtonSet: مجموعة أزرار فارغة

`newCalendarEventActionResponseBuilder()`

تنشئ هذه الدالة CalendarEventActionResponseBuilder جديدًا.

الإرجاع

CalendarEventActionResponseBuilder: CalendarEventActionResponseBuilder فارغ

`newCardAction()`

تنشئ هذه الدالة CardAction جديدًا.

الإرجاع

‫CardAction: تمثّل CardAction فارغًا.

`newCardBuilder()`

تنشئ هذه الطريقة أداة إنشاء بطاقات جديدة.

الإرجاع

‫CardBuilder: أداة إنشاء بطاقات فارغة

`newCardHeader()`

تنشئ هذه الدالة CardHeader جديدًا.

الإرجاع

‫CardHeader: تمثّل CardHeader فارغًا.

`newCardSection()`

تنشئ هذه الدالة CardSection جديدًا.

الإرجاع

‫CardSection: يمثّل قسم بطاقة فارغًا.

`newCardWithId()`

تنشئ هذه الدالة CardWithId جديدًا. يُستخدَم هذا الحقل لإرسال بطاقة في رسالة 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);

الإرجاع

CardWithId: CardWithId فارغ

`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()`

تنشئ هذه الدالة CarouselCard جديدًا.

const carouselCard = CardService.newCarouselCard().addWidget(
    CardService.newTextParagraph().setText('Text paragraph in carousel'));

الإرجاع

CarouselCard: شريحة فارغة

`newChatActionResponse()`

تنشئ هذه الدالة ChatActionResponse جديدًا.

هذه الميزة متاحة فقط لتطبيقات 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);

الإرجاع

ChatActionResponse: ChatActionResponse فارغ

`newChatResponseBuilder()`

تنشئ هذه الدالة ChatResponseBuilder جديدًا.

هذه الميزة متاحة فقط لتطبيقات 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();

الإرجاع

ChatResponseBuilder: يمثّل هذا الرمز أداة إنشاء ChatResponseBuilder فارغة.

`newChip()`

تنشئ هذه الدالة Chip جديدًا.

متاحة لتطبيقات Google Chat. في الإصدار التجريبي من إضافات Google Workspace

const chip = CardService.newChip()
                 .setLabel('Open Link')
                 .setOpenLink(CardService.newOpenLink().setUrl(
                     'https://www.google.com'));

الإرجاع

‫Chip: شريحة فارغة

`newChipList()`

تنشئ هذه الدالة ChipList جديدًا.

متاحة لتطبيقات Google Chat. في الإصدار التجريبي من إضافات Google Workspace

const chip = CardService.newChip();
// Finish building the text chip...

const chipList = CardService.newChipList()
                     .setLayout(CardService.ChipListLayout.WRAPPED)
                     .addChip(chip);

الإرجاع

‫ChipList: تمثّل ChipList فارغة.

`newCollapseControl()`

تنشئ هذه الدالة CollapseControl جديدًا.

متاحة لتطبيقات Google Chat. في الإصدار التجريبي من إضافات Google Workspace

const collapseControl =
    CardService.newCollapseControl()
        .setHorizontalAlign(CardService.HorizontalAlignment.START)
        .setExpandButton(CardService.newTextButton().setText('Expand'))
        .setCollapseButton(CardService.newTextButton().setText('Collapse'));

الإرجاع

‫CollapseControl: عنصر 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: مجموعة فارغة من الأعمدة

`newCommonWidgetAction()`

تنشئ هذه الدالة CommonWidgetAction جديدًا.

الإرجاع

CommonWidgetAction: CommonWidgetAction فارغ

`newComposeActionResponseBuilder()`

تنشئ هذه الدالة ComposeActionResponseBuilder جديدًا.

الإرجاع

‫ComposeActionResponseBuilder: أداة إنشاء ComposeActionResponse فارغة.

`newCondition()`

تنشئ هذه السمة Condition جديدة تُستخدَم للتحقّق من صحة البيانات من جهة العميل.

الإرجاع

Condition: Condition فارغ

`newDataSourceConfig()`

تُنشئ هذه الطريقة DataSourceConfig فارغًا جديدًا.

الإرجاع

DataSourceConfig: DataSourceConfig فارغ

`newDatePicker()`

تنشئ هذه الدالة DatePicker جديدًا.

الإرجاع

DatePicker: عنصر DatePicker فارغ

`newDateTimePicker()`

تنشئ هذه الدالة DateTimePicker جديدًا.

الإرجاع

DateTimePicker: عنصر DateTimePicker فارغ

`newDecoratedText()`

تنشئ هذه الدالة DecoratedText جديدًا.

الإرجاع

‫DecoratedText: يمثّل هذا النوع DecoratedText فارغًا.

`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);

الإرجاع

Dialog: Dialog فارغ

`newDialogAction()`

تنشئ هذه الدالة DialogAction جديدًا.

هذه الميزة متاحة فقط لتطبيقات 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);

الإرجاع

DialogAction: DialogAction فارغ

`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: فاصل

`newDriveDataSourceSpec()`

تنشئ هذه الدالة DriveDataSourceSpec جديدًا.

الإرجاع

DriveDataSourceSpec: DriveDataSourceSpec فارغ

`newDriveItemsSelectedActionResponseBuilder()`

تنشئ هذه الدالة DriveItemsSelectedActionResponseBuilder جديدًا.

الإرجاع

DriveItemsSelectedActionResponseBuilder: DriveItemsSelectedActionResponseBuilder فارغ

`newEditorFileScopeActionResponseBuilder()`

تنشئ هذه الدالة EditorFileScopeActionResponseBuilder جديدًا.

الإرجاع

EditorFileScopeActionResponseBuilder: EditorFileScopeActionResponseBuilder فارغ

`newEventAction()`

تنشئ هذه السمة EventAction جديدة تُستخدَم للتحقّق من صحة البيانات من جهة العميل.

الإرجاع

EventAction: EventAction فارغ

`newExpressionData()`

تنشئ هذه السمة ExpressionData جديدة تُستخدَم للتحقّق من صحة البيانات من جهة العميل.

الإرجاع

ExpressionData: ExpressionData فارغ

`newExpressionDataAction()`

تنشئ هذه السمة ExpressionDataAction جديدة تُستخدَم للتحقّق من صحة البيانات من جهة العميل.

الإرجاع

ExpressionDataAction: ExpressionDataAction فارغ

`newExpressionDataCondition()`

تنشئ هذه السمة ExpressionDataCondition جديدة تُستخدَم للتحقّق من صحة البيانات من جهة العميل.

الإرجاع

ExpressionDataCondition: ExpressionDataCondition فارغ

`newFixedFooter()`

تنشئ هذه الدالة FixedFooter جديدًا.

الإرجاع

‫FixedFooter: يمثّل هذا الرمز عنصر FixedFooter فارغًا.

`newGrid()`

تنشئ هذه الدالة Grid جديدًا.

الإرجاع

Grid: شبكة فارغة

`newGridItem()`

تنشئ هذه الدالة GridItem جديدًا.

الإرجاع

‫GridItem: يمثّل GridItem فارغًا.

`newHostAppDataSource()`

تنشئ هذه الدالة HostAppDataSource جديدًا.

الإرجاع

HostAppDataSource — A HostAppDataSource

`newIconImage()`

تنشئ هذه الدالة IconImage جديدًا.

الإرجاع

‫IconImage: صورة رمز فارغ

`newImage()`

تنشئ هذه الدالة Image جديدًا.

الإرجاع

‫Image: صورة فارغة

`newImageButton()`

تنشئ هذه الدالة ImageButton جديدًا.

الإرجاع

‫ImageButton: يمثّل ImageButton فارغًا.

`newImageComponent()`

تنشئ هذه الدالة ImageComponent جديدًا.

الإرجاع

‫ImageComponent: يمثّل ImageComponent فارغًا.

`newImageCropStyle()`

تنشئ هذه الدالة ImageCropStyle جديدًا.

الإرجاع

‫ImageCropStyle: يمثّل هذا النوع ImageCropStyle فارغًا.

`newKeyValue()`

تنشئ هذه الدالة KeyValue جديدًا.

الإرجاع

‫KeyValue: KeyValue فارغ

`newLinkPreview()`

تنشئ هذه الدالة LinkPreview جديدًا.

const decoratedText =
    CardService.newDecoratedText().setTopLabel('Hello').setText('Hi!');

const cardSection = CardService.newCardSection().addWidget(decoratedText);

const card = CardService.newCardBuilder().addSection(cardSection).build();

return CardService.newLinkPreview().setPreviewCard(card).setTitle(
    'Smart chip title');

الإرجاع

‫LinkPreview: LinkPreview فارغ

`newMaterialIcon()`

تنشئ هذه الدالة MaterialIcon جديدًا.

متاحة لتطبيقات 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();

الإرجاع

‫MaterialIcon: يمثّل MaterialIcon فارغًا.

`newNavigation()`

تنشئ هذه الدالة Navigation جديدًا.

الإرجاع

‫Navigation: تمثّل هذه السمة Navigation فارغًا.

`newNotification()`

تنشئ هذه الدالة Notification جديدًا.

الإرجاع

Notification: إشعار فارغ

`newOpenLink()`

تنشئ هذه الدالة OpenLink جديدًا.

الإرجاع

‫OpenLink: رابط OpenLink فارغ

`newOverflowMenu()`

تنشئ هذه الدالة OverflowMenu جديدًا.

متاحة لتطبيقات Google Chat. في الإصدار التجريبي من إضافات Google Workspace

const overflowMenuItem = CardService.newOverflowMenuItem();
// Finish building the overflow menu item...

const overflowMenu =
    CardService.newOverflowMenu().addMenuItem(overflowMenuItem);

الإرجاع

‫OverflowMenu: قائمة OverflowMenu فارغة

`newOverflowMenuItem()`

تنشئ هذه الدالة OverflowMenuItem جديدًا.

متاحة لتطبيقات 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'));

الإرجاع

‫OverflowMenuItem: OverflowMenuItem فارغ

`newPlatformDataSource()`

تنشئ هذه الدالة PlatformDataSource جديدًا.

الإرجاع

PlatformDataSource: PlatformDataSource فارغ

`newSelectionInput()`

تنشئ هذه الدالة SelectionInput جديدًا.

الإرجاع

‫SelectionInput: يمثّل SelectionInput فارغًا.

`newSuggestions()`

تنشئ هذه الدالة Suggestions جديدًا.

الإرجاع

Suggestions: اقتراحات فارغة

`newSuggestionsResponseBuilder()`

تنشئ هذه الدالة SuggestionsResponseBuilder جديدًا.

الإرجاع

‫SuggestionsResponseBuilder: أداة إنشاء فارغة لفئة SuggestionsResponse.

`newSwitch()`

تنشئ هذه الدالة Switch جديدًا.

الإرجاع

Switch: مفتاح تحكّم فارغ

`newTextButton()`

تنشئ هذه الدالة TextButton جديدًا.

الإرجاع

‫TextButton: يمثّل هذا الرمز زر TextButton فارغًا.

`newTextInput()`

تنشئ هذه الدالة TextInput جديدًا.

الإرجاع

‫TextInput: تمثّل عنصر TextInput فارغًا.

`newTextParagraph()`

تنشئ هذه الدالة TextParagraph جديدًا.

الإرجاع

TextParagraph: تمثّل TextParagraph فارغًا.

`newTimePicker()`

تنشئ هذه الدالة TimePicker جديدًا.

الإرجاع

TimePicker: عنصر TimePicker فارغ

`newTrigger()`

تنشئ هذه الدالة عنصر Trigger جديدًا وتُرجعه، ويُستخدم هذا العنصر للتحقّق من صحة البيانات من جهة العميل.

الإرجاع

Trigger: Trigger فارغ

`newUniversalActionResponseBuilder()`

تنشئ هذه الدالة UniversalActionResponseBuilder جديدًا.

الإرجاع

‫UniversalActionResponseBuilder: أداة إنشاء UniversalActionResponse فارغة.

`newUpdateDraftActionResponseBuilder()`

تنشئ هذه الدالة UpdateDraftActionResponseBuilder جديدًا.

الإرجاع

‫UpdateDraftActionResponseBuilder: يمثّل UpdateDraftActionResponseBuilder فارغًا.

`newUpdateDraftBccRecipientsAction()`

تُنشئ هذه الطريقة UpdateDraftBccRecipientsAction جديدًا.

الإرجاع

‫UpdateDraftBccRecipientsAction: إجراء UpdateDraftBccRecipientsAction فارغ

`newUpdateDraftBodyAction()`

تنشئ هذه الدالة UpdateDraftBodyAction جديدًا.

الإرجاع

‫UpdateDraftBodyAction: تمثّل UpdateDraftBodyAction فارغًا.

`newUpdateDraftCcRecipientsAction()`

تنشئ هذه الدالة UpdateDraftCcRecipientsAction جديدًا.

الإرجاع

‫UpdateDraftCcRecipientsAction: Empty UpdateDraftCcRecipientsAction.

`newUpdateDraftSubjectAction()`

تنشئ هذه الدالة UpdateDraftSubjectAction جديدًا.

الإرجاع

‫UpdateDraftSubjectAction: UpdateDraftSubjectAction فارغ

`newUpdateDraftToRecipientsAction()`

تنشئ هذه الدالة UpdateDraftToRecipientsAction جديدًا.

الإرجاع

‫UpdateDraftToRecipientsAction: UpdateDraftToRecipientsAction فارغ

`newUpdateVisibilityAction()`

تنشئ هذه الدالة UpdateVisibilityAction جديدًا.

الإرجاع

UpdateVisibilityAction: UpdateVisibilityAction فارغ

`newValidation()`

تنشئ هذه الدالة Validation جديدًا.

متاحة لتطبيقات Google Chat وإضافات Google Workspace

const validation =
    CardService.newValidation().setCharacterLimit(5).setInputType(
        CardService.InputType.EMAIL);

الإرجاع

Validation: عملية تحقّق فارغة.

`newWorkflowDataSource()`

تنشئ هذه الدالة WorkflowDataSource جديدًا.

الإرجاع

WorkflowDataSource: WorkflowDataSource فارغ

Class CardService تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

الخصائص

الطُرق

مستندات تفصيلية

newAction()

الإرجاع

newActionResponseBuilder()

الإرجاع

newActionStatus()

الإرجاع

newAttachment()

الإرجاع

newAuthorizationAction()

الإرجاع

newAuthorizationException()

الإرجاع

newBorderStyle()

الإرجاع

newButtonSet()

الإرجاع

newCalendarEventActionResponseBuilder()

الإرجاع

newCardAction()

الإرجاع

newCardBuilder()

الإرجاع

newCardHeader()

الإرجاع

newCardSection()

الإرجاع

newCardWithId()

الإرجاع

newCarousel()

الإرجاع

newCarouselCard()

الإرجاع

newChatActionResponse()

الإرجاع

newChatResponseBuilder()

الإرجاع

newChip()

الإرجاع

newChipList()

الإرجاع

newCollapseControl()

الإرجاع

newColumn()

الإرجاع

newColumns()

الإرجاع

newCommonWidgetAction()

الإرجاع

newComposeActionResponseBuilder()

الإرجاع

newCondition()

الإرجاع

newDataSourceConfig()

الإرجاع

newDatePicker()

الإرجاع

newDateTimePicker()

الإرجاع

newDecoratedText()

الإرجاع

newDialog()

الإرجاع

newDialogAction()

الإرجاع

newDivider()

الإرجاع

newDriveDataSourceSpec()

الإرجاع

newDriveItemsSelectedActionResponseBuilder()

الإرجاع

newEditorFileScopeActionResponseBuilder()

الإرجاع

newEventAction()

الإرجاع

newExpressionData()

الإرجاع

Class CardService

`newAction()`

`newActionResponseBuilder()`

`newActionStatus()`

`newAttachment()`

`newAuthorizationAction()`

`newAuthorizationException()`

`newBorderStyle()`

`newButtonSet()`

`newCalendarEventActionResponseBuilder()`

`newCardAction()`

`newCardBuilder()`

`newCardHeader()`

`newCardSection()`

`newCardWithId()`

`newCarousel()`

`newCarouselCard()`

`newChatActionResponse()`

`newChatResponseBuilder()`

`newChip()`

`newChipList()`

`newCollapseControl()`

`newColumn()`

`newColumns()`

`newCommonWidgetAction()`

`newComposeActionResponseBuilder()`

`newCondition()`

`newDataSourceConfig()`

`newDatePicker()`

`newDateTimePicker()`

`newDecoratedText()`

`newDialog()`

`newDialogAction()`

`newDivider()`

`newDriveDataSourceSpec()`

`newDriveItemsSelectedActionResponseBuilder()`

`newEditorFileScopeActionResponseBuilder()`

`newEventAction()`

`newExpressionData()`

`newExpressionDataAction()`

`newExpressionDataCondition()`

`newFixedFooter()`

`newGrid()`

`newGridItem()`

`newHostAppDataSource()`

`newIconImage()`

`newImage()`

`newImageButton()`

`newImageComponent()`

`newImageCropStyle()`

`newKeyValue()`

`newLinkPreview()`

`newMaterialIcon()`

`newNavigation()`

`newNotification()`

`newOpenLink()`

`newOverflowMenu()`

`newOverflowMenuItem()`

`newPlatformDataSource()`

`newSelectionInput()`

`newSuggestions()`

`newSuggestionsResponseBuilder()`

`newSwitch()`

`newTextButton()`

`newTextInput()`

`newTextParagraph()`

`newTimePicker()`

`newTrigger()`

`newUniversalActionResponseBuilder()`

`newUpdateDraftActionResponseBuilder()`

`newUpdateDraftBccRecipientsAction()`

`newUpdateDraftBodyAction()`

`newUpdateDraftCcRecipientsAction()`

`newUpdateDraftSubjectAction()`