Class CardService

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

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

return CardService.newCardBuilder()
         .setHeader(CardService.newCardHeader().setTitle("CardTitle"))
         .build();

أو يمكنك إرجاع عدة بطاقات كما يلي:

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

أماكن إقامة

الخاصيةالنوعالوصف
BorderTypeBorderTypeتعداد BorderType
ComposedEmailTypeComposedEmailTypeتعداد ComposedEmailType
ContentTypeContentTypeتعداد ContentType
GridItemLayoutGridItemLayoutتعداد GridItemLayout
HorizontalAlignmentHorizontalAlignmentتعداد HorizontalAlignment
IconIconتعداد Icon
ImageCropTypeImageCropTypeتعداد ImageCropType
ImageStyleImageStyleتعداد ImageStyle
LoadIndicatorLoadIndicatorتعداد LoadIndicator
OnCloseOnCloseتعداد OnClose
OpenAsOpenAsتعداد OpenAs
SelectionInputTypeSelectionInputTypeتعداد SelectionInputType
TextButtonStyleTextButtonStyleتعداد TextButtonStyle
UpdateDraftBodyTypeUpdateDraftBodyTypeتعداد UpdateDraftBodyType

الطُرق

الطريقةنوع الإرجاعوصف قصير
newAction()Actionتنشئ Action جديدة.
newActionResponseBuilder()ActionResponseBuilderتنشئ ActionResponseBuilder جديدة.
newAttachment()Attachmentتنشئ Attachment جديدة.
newAuthorizationAction()AuthorizationActionتنشئ AuthorizationAction جديدة.
newAuthorizationException()AuthorizationExceptionتنشئ AuthorizationException جديدة.
newBorderStyle()BorderStyleتنشئ BorderStyle جديدة.
newButtonSet()ButtonSetتنشئ ButtonSet جديدة.
newCalendarEventActionResponseBuilder()CalendarEventActionResponseBuilderتنشئ CalendarEventActionResponseBuilder جديدة.
newCardAction()CardActionتنشئ CardAction جديدة.
newCardBuilder()CardBuilderتنشئ CardBuilder جديدة.
newCardHeader()CardHeaderتنشئ CardHeader جديدة.
newCardSection()CardSectionتنشئ CardSection جديدة.
newComposeActionResponseBuilder()ComposeActionResponseBuilderتنشئ ComposeActionResponseBuilder جديدة.
newDatePicker()DatePickerتنشئ DatePicker جديدة.
newDateTimePicker()DateTimePickerتنشئ DateTimePicker جديدة.
newDecoratedText()DecoratedTextتنشئ DecoratedText جديدة.
newDivider()Dividerتنشئ Divider جديدة.
newDriveItemsSelectedActionResponseBuilder()DriveItemsSelectedActionResponseBuilderتنشئ DriveItemsSelectedActionResponseBuilder جديدة.
newEditorFileScopeActionResponseBuilder()EditorFileScopeActionResponseBuilderتنشئ EditorFileScopeActionResponseBuilder جديدة.
newFixedFooter()FixedFooterتنشئ FixedFooter جديدة.
newGrid()Gridتنشئ Grid جديدة.
newGridItem()GridItemتنشئ GridItem جديدة.
newIconImage()IconImageتنشئ IconImage جديدة.
newImage()Imageتنشئ Image جديدة.
newImageButton()ImageButtonتنشئ ImageButton جديدة.
newImageComponent()ImageComponentتنشئ ImageComponent جديدة.
newImageCropStyle()ImageCropStyleتنشئ ImageCropStyle جديدة.
newKeyValue()KeyValueتنشئ KeyValue جديدة.
newNavigation()Navigationتنشئ Navigation جديدة.
newNotification()Notificationتنشئ Notification جديدة.
newOpenLink()OpenLinkتنشئ OpenLink جديدة.
newSelectionInput()SelectionInputتنشئ SelectionInput جديدة.
newSuggestions()Suggestionsتنشئ Suggestions جديدة.
newSuggestionsResponseBuilder()SuggestionsResponseBuilderتنشئ SuggestionsResponseBuilder جديدة.
newSwitch()Switchتنشئ Switch جديدة.
newTextButton()TextButtonتنشئ TextButton جديدة.
newTextInput()TextInputتنشئ TextInput جديدة.
newTextParagraph()TextParagraphتنشئ TextParagraph جديدة.
newTimePicker()TimePickerتنشئ TimePicker جديدة.
newUniversalActionResponseBuilder()UniversalActionResponseBuilderتنشئ UniversalActionResponseBuilder جديدة.
newUpdateDraftActionResponseBuilder()UpdateDraftActionResponseBuilderتنشئ UpdateDraftActionResponseBuilder جديدة.
newUpdateDraftBccRecipientsAction()UpdateDraftBccRecipientsActionإنشاء UpdateDraftBccRecipientsAction جديد؛
newUpdateDraftBodyAction()UpdateDraftBodyActionتنشئ UpdateDraftBodyAction جديدة.
newUpdateDraftCcRecipientsAction()UpdateDraftCcRecipientsActionتنشئ UpdateDraftCcRecipientsAction جديدة.
newUpdateDraftSubjectAction()UpdateDraftSubjectActionتنشئ UpdateDraftSubjectAction جديدة.
newUpdateDraftToRecipientsAction()UpdateDraftToRecipientsActionتنشئ UpdateDraftToRecipientsAction جديدة.

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

newAction()

تنشئ Action جديدة.

تذكرة ذهاب وعودة

Action - إجراء فارغ.


newActionResponseBuilder()

تنشئ ActionResponseBuilder جديدة.

تذكرة ذهاب وعودة

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


newAttachment()

تنشئ Attachment جديدة.

تذكرة ذهاب وعودة

Attachment - مرفق فارغ.


newAuthorizationAction()

تنشئ AuthorizationAction جديدة.

تذكرة ذهاب وعودة

AuthorizationAction — إجراء تفويض فارغ.


newAuthorizationException()

تنشئ AuthorizationException جديدة.

تذكرة ذهاب وعودة

AuthorizationException — استثناء تفويض.


newBorderStyle()

تنشئ BorderStyle جديدة.

تذكرة ذهاب وعودة

BorderStyle — نمط حد خالٍ.


newButtonSet()

تنشئ ButtonSet جديدة.

تذكرة ذهاب وعودة

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


newCalendarEventActionResponseBuilder()

تنشئ CalendarEventActionResponseBuilder جديدة.

تذكرة ذهاب وعودة

CalendarEventActionResponseBuilderCalendarEventActionResponseBuilder فارغ.


newCardAction()

تنشئ CardAction جديدة.

تذكرة ذهاب وعودة

CardAction — إجراء بطاقة فارغ.


newCardBuilder()

تنشئ CardBuilder جديدة.

تذكرة ذهاب وعودة

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


newCardHeader()

تنشئ CardHeader جديدة.

تذكرة ذهاب وعودة

CardHeader — عنوان بطاقة فارغ.


newCardSection()

تنشئ CardSection جديدة.

تذكرة ذهاب وعودة

CardSection — قسم بطاقة فارغ.


newComposeActionResponseBuilder()

تنشئ ComposeActionResponseBuilder جديدة.

تذكرة ذهاب وعودة

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


newDatePicker()

تنشئ DatePicker جديدة.

تذكرة ذهاب وعودة

DatePicker — منتقي التاريخ فارغ.


newDateTimePicker()

تنشئ DateTimePicker جديدة.

تذكرة ذهاب وعودة

DateTimePicker — منتقي التاريخ والوقت فارغ.


newDecoratedText()

تنشئ DecoratedText جديدة.

تذكرة ذهاب وعودة

DecoratedText: نص مزيّن فارغ.


newDivider()

تنشئ Divider جديدة. يُنشئ النموذج التالي بطاقة بسيطة تتألف من فقرتين تفصل بينها فاصلة.

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;
}

تذكرة ذهاب وعودة

Divider — فاصل


newDriveItemsSelectedActionResponseBuilder()


newEditorFileScopeActionResponseBuilder()


newFixedFooter()

تنشئ FixedFooter جديدة.

تذكرة ذهاب وعودة

FixedFooter — تذييل ثابت فارغ.


newGrid()

تنشئ Grid جديدة.

تذكرة ذهاب وعودة

Grid — شبكة فارغة.


newGridItem()

تنشئ GridItem جديدة.

تذكرة ذهاب وعودة

GridItem — عنصر GridItem فارغ.


newIconImage()

تنشئ IconImage جديدة.

تذكرة ذهاب وعودة

IconImage — صورة رمز فارغة.


newImage()

تنشئ Image جديدة.

تذكرة ذهاب وعودة

Image — صورة فارغة.


newImageButton()

تنشئ ImageButton جديدة.

تذكرة ذهاب وعودة

ImageButton — زر صورة فارغ.


newImageComponent()

تنشئ ImageComponent جديدة.

تذكرة ذهاب وعودة

ImageComponent: مكوّن Image فارغ.


newImageCropStyle()

تنشئ ImageCropStyle جديدة.

تذكرة ذهاب وعودة

ImageCropStyle: — ImageCropStyle فارغة.


newKeyValue()

تنشئ KeyValue جديدة.

تذكرة ذهاب وعودة

KeyValue — قيمة Key فارغة.


newNavigation()

تنشئ Navigation جديدة.

تذكرة ذهاب وعودة

Navigation — قائمة تنقُّل فارغة.


newNotification()

تنشئ Notification جديدة.

تذكرة ذهاب وعودة

Notification — إشعار فارغ.


تنشئ OpenLink جديدة.

تذكرة ذهاب وعودة

OpenLink — OpenLink فارغ.


newSelectionInput()

تنشئ SelectionInput جديدة.

تذكرة ذهاب وعودة

SelectionInput — comSelectInput فارغ.


newSuggestions()

تنشئ Suggestions جديدة.

تذكرة ذهاب وعودة

Suggestions — اقتراحات فارغة.


newSuggestionsResponseBuilder()

تنشئ SuggestionsResponseBuilder جديدة.

تذكرة ذهاب وعودة

SuggestionsResponseBuilder: أداة إنشاء suggestionsResponse فارغة


newSwitch()

تنشئ Switch جديدة.

تذكرة ذهاب وعودة

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


newTextButton()

تنشئ TextButton جديدة.

تذكرة ذهاب وعودة

TextButton — زر نصي فارغ.


newTextInput()

تنشئ TextInput جديدة.

تذكرة ذهاب وعودة

TextInput — إدخال إدخال نصي فارغ.


newTextParagraph()

تنشئ TextParagraph جديدة.

تذكرة ذهاب وعودة

TextParagraph — TextParagraph فارغ.


newTimePicker()

تنشئ TimePicker جديدة.

تذكرة ذهاب وعودة

TimePicker — أداة اختيار الوقت فارغة.


newUniversalActionResponseBuilder()

تنشئ UniversalActionResponseBuilder جديدة.

تذكرة ذهاب وعودة

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


newUpdateDraftActionResponseBuilder()

تنشئ UpdateDraftActionResponseBuilder جديدة.

تذكرة ذهاب وعودة

UpdateDraftActionResponseBuilder — تحديث المسودةمسودةActionResponseBuilder.


newUpdateDraftBccRecipientsAction()

إنشاء UpdateDraftBccRecipientsAction جديد؛

تذكرة ذهاب وعودة

UpdateDraftBccRecipientsAction — تحديث مسودة فيالمستلمين فارغين.


newUpdateDraftBodyAction()

تنشئ UpdateDraftBodyAction جديدة.

تذكرة ذهاب وعودة

UpdateDraftBodyAction — هناك مسوّدة فارغة من TextمسودةAction


newUpdateDraftCcRecipientsAction()

تنشئ UpdateDraftCcRecipientsAction جديدة.

تذكرة ذهاب وعودة

UpdateDraftCcRecipientsAction — إجراء مسودة UpdatecnReceivedsAction فارغ.


newUpdateDraftSubjectAction()

تنشئ UpdateDraftSubjectAction جديدة.

تذكرة ذهاب وعودة

UpdateDraftSubjectAction — حدث UpdateمسودةSubjectAction فارغ.


newUpdateDraftToRecipientsAction()

تنشئ UpdateDraftToRecipientsAction جديدة.

تذكرة ذهاب وعودة

UpdateDraftToRecipientsAction — حدث UpdateمسودةToReceivedsAction فارغ.