این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Class CardService

سرویس کارت امکان ایجاد کارت‌های عمومی مورد استفاده در محصولات توسعه‌پذیر مختلف گوگل، مانند افزونه‌های 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();
}

نمونه برای کارت برنامه چت.

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 Type`	`Border Type`	شمارش `Border Type` .
`Chip List Layout`	`Chip List Layout`	شمارش `Chip List Layout` .
`Composed Email Type`	`Composed Email Type`	شمارش `Composed Email Type` .
`Content Type`	`Content Type`	شمارش `Content Type` .
`Expression Data Action Type`	`Expression Data Action Type`	شمارش `Expression Data Action Type` .
`Expression Data Condition Type`	`Expression Data Condition Type`	شمارش `Expression Data Condition Type` .
`Grid Item Layout`	`Grid Item Layout`	شمارش `Grid Item Layout` .
`Horizontal Alignment`	`Horizontal Alignment`	شمارش `Horizontal Alignment` .
`Icon`	`Icon`	شمارش `Icon` .
`Image Button Style`	`Image Button Style`	شمارش `Image Button Style` .
`Image Crop Type`	`Image Crop Type`	شمارش `Image Crop Type` .
`Image Style`	`Image Style`	شمارش `Image Style` .
`Input Type`	`Input Type`	شمارش `Input Type` .
`Load Indicator`	`Load Indicator`	شمارش `Load Indicator` .
`On Close`	`On Close`	شمارش `On Close` .
`Open As`	`Open As`	شمارش `Open As` .
`Selection Input Type`	`Selection Input Type`	شمارش `Selection Input Type` .
`Text Button Style`	`Text Button Style`	شمارش `Text Button Style` .
`Update Draft Body Type`	`Update Draft Body Type`	شمارش `Update Draft Body Type` .
`Visibility`	`Visibility`	شمارش `Visibility` .
`Workflow Data Source Type`	`Workflow Data Source Type`	شمارش `Workflow Data Source Type` .

روش‌ها

روش	نوع بازگشتی	شرح مختصر
`new Action()`	`Action`	یک `Action` جدید ایجاد می‌کند.
`new Action Response Builder()`	`Action Response Builder`	یک `Action Response Builder` جدید ایجاد می‌کند.
`new Action Status()`	`Action Status`	یک `Action Status` جدید ایجاد می‌کند.
`new Attachment()`	`Attachment`	یک `Attachment` جدید ایجاد می‌کند.
`new Authorization Action()`	`Authorization Action`	یک `Authorization Action` جدید ایجاد می‌کند.
`new Authorization Exception()`	`Authorization Exception`	یک `Authorization Exception` جدید ایجاد می‌کند.
`new Border Style()`	`Border Style`	یک `Border Style` جدید ایجاد می‌کند.
`new Button Set()`	`Button Set`	یک `Button Set` جدید ایجاد می‌کند.
`new Calendar Event Action Response Builder()`	`Calendar Event Action Response Builder`	یک `Calendar Event Action Response Builder` جدید ایجاد می‌کند.
`new Card Action()`	`Card Action`	یک `Card Action` جدید ایجاد می‌کند.
`new Card Builder()`	`Card Builder`	یک سازنده کارت جدید ایجاد می‌کند.
`new Card Header()`	`Card Header`	یک `Card Header` جدید ایجاد می‌کند.
`new Card Section()`	`Card Section`	یک `Card Section` جدید ایجاد می‌کند.
`new Card With Id()`	`Card With Id`	یک `Card With Id` ایجاد می‌کند.
`new Carousel()`	`Carousel`	یک `Carousel` ایجاد می‌کند.
`new Carousel Card()`	`Carousel Card`	یک `Carousel Card` جدید ایجاد می‌کند.
`new Chat Action Response()`	`Chat Action Response`	یک `Chat Action Response` ایجاد می‌کند.
`new Chat Response Builder()`	`Chat Response Builder`	یک `Chat Response Builder` جدید ایجاد می‌کند.
`new Chip()`	`Chip`	یک `Chip` جدید ایجاد می‌کند.
`new Chip List()`	`Chip List`	یک `Chip List` جدید ایجاد می‌کند.
`new Collapse Control()`	`Collapse Control`	یک `Collapse Control` جدید ایجاد می‌کند.
`new Column()`	`Column`	یک `Column` جدید ایجاد می‌کند.
`new Columns()`	`Columns`	یک مجموعه جدید از `Columns` ایجاد می‌کند.
`new Compose Action Response Builder()`	`Compose Action Response Builder`	یک `Compose Action Response Builder` جدید ایجاد می‌کند.
`new Date Picker()`	`Date Picker`	یک `Date Picker` جدید ایجاد می‌کند.
`new Date Time Picker()`	`Date Time Picker`	یک `Date Time Picker` جدید ایجاد می‌کند.
`new Decorated Text()`	`Decorated Text`	یک `Decorated Text` جدید ایجاد می‌کند.
`new Dialog()`	`Dialog`	یک `Dialog` جدید ایجاد می‌کند.
`new Dialog Action()`	`Dialog Action`	یک `Dialog Action` جدید ایجاد می‌کند.
`new Divider()`	`Divider`	یک `Divider` جدید ایجاد می‌کند.
`new Drive Items Selected Action Response Builder()`	`Drive Items Selected Action Response Builder`	یک `Drive Items Selected Action Response Builder` جدید ایجاد می‌کند.
`new Editor File Scope Action Response Builder()`	`Editor File Scope Action Response Builder`	یک `Editor File Scope Action Response Builder` ایجاد می‌کند.
`new Fixed Footer()`	`Fixed Footer`	یک `Fixed Footer` جدید ایجاد می‌کند.
`new Grid()`	`Grid`	یک `Grid` جدید ایجاد می‌کند.
`new Grid Item()`	`Grid Item`	یک `Grid Item` جدید ایجاد می‌کند.
`new Host App Data Source()`	`Host App Data Source`	یک `Host App Data Source` جدید ایجاد می‌کند و یک `Host App Data Source` خالی برمی‌گرداند.
`new Icon Image()`	`Icon Image`	یک `Icon Image` جدید ایجاد می‌کند.
`new Image()`	`Image`	یک `Image` جدید ایجاد می‌کند.
`new Image Button()`	`Image Button`	یک `Image Button` جدید ایجاد می‌کند.
`new Image Component()`	`Image Component`	یک `Image Component` جدید ایجاد می‌کند.
`new Image Crop Style()`	`Image Crop Style`	یک `Image Crop Style` جدید ایجاد می‌کند.
`new Key Value()`	`Key Value`	یک `Key Value` جدید ایجاد می‌کند.
`new Link Preview()`	`Link Preview`	یک `Link Preview` جدید ایجاد می‌کند.
`new Material Icon()`	`Material Icon`	یک `Material Icon` جدید ایجاد می‌کند.
`new Navigation()`	`Navigation`	یک `Navigation` جدید ایجاد می‌کند.
`new Notification()`	`Notification`	یک `Notification` جدید ایجاد می‌کند.
`new Open Link()`	`Open Link`	یک `Open Link` جدید ایجاد می‌کند.
`new Overflow Menu()`	`Overflow Menu`	یک `Overflow Menu` جدید ایجاد می‌کند.
`new Overflow Menu Item()`	`Overflow Menu Item`	یک `Overflow Menu Item` جدید ایجاد می‌کند.
`new Selection Input()`	`Selection Input`	یک `Selection Input` جدید ایجاد می‌کند.
`new Suggestions()`	`Suggestions`	یک `Suggestions` جدید ایجاد می‌کند.
`new Suggestions Response Builder()`	`Suggestions Response Builder`	یک `Suggestions Response Builder` جدید ایجاد می‌کند.
`new Switch()`	`Switch`	یک `Switch` جدید ایجاد می‌کند.
`new Text Button()`	`Text Button`	یک `Text Button` جدید ایجاد می‌کند.
`new Text Input()`	`Text Input`	یک `Text Input` جدید ایجاد می‌کند.
`new Text Paragraph()`	`Text Paragraph`	یک `Text Paragraph` جدید ایجاد می‌کند.
`new Time Picker()`	`Time Picker`	یک `Time Picker` جدید ایجاد می‌کند.
`new Universal Action Response Builder()`	`Universal Action Response Builder`	یک `Universal Action Response Builder` جدید ایجاد می‌کند.
`new Update Draft Action Response Builder()`	`Update Draft Action Response Builder`	یک `Update Draft Action Response Builder` جدید ایجاد می‌کند.
`new Update Draft Bcc Recipients Action()`	`Update Draft Bcc Recipients Action`	یک `Update Draft Bcc Recipients Action` ایجاد می‌کند؛
`new Update Draft Body Action()`	`Update Draft Body Action`	یک `Update Draft Body Action` ایجاد می‌کند.
`new Update Draft Cc Recipients Action()`	`Update Draft Cc Recipients Action`	یک `Update Draft Cc Recipients Action` ایجاد می‌کند.
`new Update Draft Subject Action()`	`Update Draft Subject Action`	یک `Update Draft Subject Action` جدید ایجاد می‌کند.
`new Update Draft To Recipients Action()`	`Update Draft To Recipients Action`	یک `Update Draft To Recipients Action` ایجاد می‌کند.
`new Validation()`	`Validation`	یک `Validation` جدید ایجاد می‌کند.

مستندات دقیق

`new Action()`

یک Action جدید ایجاد می‌کند.

بازگشت

Action — یک اکشن خالی.

`new Action Response Builder()`

یک Action Response Builder جدید ایجاد می‌کند.

بازگشت

Action Response Builder — یک سازنده‌ی اکشن‌ریسپانس خالی.

`new Action Status()`

یک Action Status جدید ایجاد می‌کند.

فقط برای برنامه‌های Google Chat در دسترس است. برای افزونه‌های Google Workspace در دسترس نیست.

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

بازگشت

Action Status — یک وضعیت اقدام خالی.

`new Attachment()`

یک Attachment جدید ایجاد می‌کند.

بازگشت

Attachment — یک پیوست خالی.

`new Authorization Action()`

یک Authorization Action جدید ایجاد می‌کند.

بازگشت

Authorization Action — یک اقدام مجوزدهی خالی.

`new Authorization Exception()`

یک Authorization Exception جدید ایجاد می‌کند.

بازگشت

Authorization Exception - یک استثنای مجوز خالی.

`new Border Style()`

یک Border Style جدید ایجاد می‌کند.

بازگشت

Border Style - یک BorderStyle خالی.

`new Button Set()`

یک Button Set جدید ایجاد می‌کند.

بازگشت

Button Set - یک مجموعه دکمه خالی.

`new Calendar Event Action Response Builder()`

یک Calendar Event Action Response Builder جدید ایجاد می‌کند.

بازگشت

Calendar Event Action Response Builder — یک Calendar Event Action Response Builder خالی.

`new Card Action()`

یک Card Action جدید ایجاد می‌کند.

بازگشت

Card Action — یک اکشن کارت خالی.

`new Card Builder()`

یک سازنده کارت جدید ایجاد می‌کند.

بازگشت

Card Builder — یک سازنده کارت خالی.

`new Card Header()`

یک Card Header جدید ایجاد می‌کند.

بازگشت

Card Header — یک سربرگ کارت خالی.

`new Card Section()`

یک Card Section جدید ایجاد می‌کند.

بازگشت

Card Section — یک بخش کارت خالی.

`new Card With Id()`

یک Card With Id ایجاد می‌کند. این برای ارسال کارت در پیام گوگل چت استفاده می‌شود. شناسه کارت، شناسه‌ای منحصر به فرد برای یک کارت در یک پیام هنگام ارسال چندین کارت است.

فقط برای برنامه‌های 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 With Id — یک Card With Id .

`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 Card جدید ایجاد می‌کند.

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

بازگشت

Carousel Card - یک چیپ خالی.

`new Chat Action Response()`

یک Chat Action Response ایجاد می‌کند.

فقط برای برنامه‌های 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);

بازگشت

Chat Action Response — یک Chat Action Response خالی.

`new Chat Response Builder()`

یک Chat Response Builder جدید ایجاد می‌کند.

فقط برای برنامه‌های 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 Response Builder - یک سازنده پاسخ چت خالی.

`new Chip()`

یک Chip جدید ایجاد می‌کند.

برای برنامه‌های چت گوگل موجود است. در پیش‌نمایش توسعه‌دهندگان برای افزونه‌های Google Workspace.

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

بازگشت

Chip — یک چیپ خالی.

`new Chip List()`

یک Chip List جدید ایجاد می‌کند.

برای برنامه‌های چت گوگل موجود است. در پیش‌نمایش توسعه‌دهندگان برای افزونه‌های Google Workspace.

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

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

بازگشت

Chip List - یک فهرست تراشه خالی.

`new Collapse Control()`

یک Collapse Control جدید ایجاد می‌کند.

برای برنامه‌های چت گوگل موجود است. در پیش‌نمایش توسعه‌دهندگان برای افزونه‌های Google Workspace.

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

بازگشت

Collapse Control - یک 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 Action Response Builder جدید ایجاد می‌کند.

بازگشت

Compose Action Response Builder — یک سازنده‌ی خالی ComposeActionResponse.

`new Date Picker()`

یک Date Picker جدید ایجاد می‌کند.

بازگشت

Date Picker - یک انتخابگر تاریخ خالی.

`new Date Time Picker()`

یک Date Time Picker جدید ایجاد می‌کند.

بازگشت

Date Time Picker - یک انتخابگر تاریخ و زمان خالی.

`new Decorated Text()`

یک Decorated Text جدید ایجاد می‌کند.

بازگشت

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

بازگشت

Dialog — یک Dialog خالی.

`new Dialog Action()`

یک Dialog Action جدید ایجاد می‌کند.

فقط برای برنامه‌های 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 Action — یک Dialog Action خالی.

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

یک Fixed Footer جدید ایجاد می‌کند.

بازگشت

Fixed Footer — یک FixedFooter خالی.

`new Grid()`

یک Grid جدید ایجاد می‌کند.

بازگشت

Grid - یک شبکه خالی.

`new Grid Item()`

یک Grid Item جدید ایجاد می‌کند.

بازگشت

Grid Item - یک آیتم شبکه‌ای خالی.

`new Host App Data Source()`

یک Host App Data Source جدید ایجاد می‌کند و یک Host App Data Source خالی برمی‌گرداند.

بازگشت

Host App Data Source

`new Icon Image()`

یک Icon Image جدید ایجاد می‌کند.

بازگشت

Icon Image — یک تصویر آیکون خالی.

`new Image()`

یک Image جدید ایجاد می‌کند.

بازگشت

Image — یک تصویر خالی.

`new Image Button()`

یک Image Button جدید ایجاد می‌کند.

بازگشت

Image Button - یک دکمه تصویر خالی.

`new Image Component()`

یک Image Component جدید ایجاد می‌کند.

بازگشت

Image Component - یک کامپوننت تصویر خالی.

`new Image Crop Style()`

یک Image Crop Style جدید ایجاد می‌کند.

بازگشت

Image Crop Style — یک ImageCropStyle خالی.

`new Key Value()`

یک Key Value جدید ایجاد می‌کند.

بازگشت

Key Value - یک مقدار کلید خالی.

`new Link Preview()`

یک Link Preview جدید ایجاد می‌کند.

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 Preview — یک پیش‌نمایش لینک خالی.

`new Material Icon()`

یک Material Icon جدید ایجاد می‌کند.

برای برنامه‌های 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 Icon — یک آیکون متریال خالی.

`new Navigation()`

یک Navigation جدید ایجاد می‌کند.

بازگشت

Navigation — یک ناوبری خالی.

`new Notification()`

یک Notification جدید ایجاد می‌کند.

بازگشت

Notification — یک اعلان خالی.

`new Open Link()`

یک Open Link جدید ایجاد می‌کند.

بازگشت

Open Link - یک پیوند باز خالی.

`new Overflow Menu()`

یک Overflow Menu جدید ایجاد می‌کند.

برای برنامه‌های چت گوگل موجود است. در پیش‌نمایش توسعه‌دهندگان برای افزونه‌های Google Workspace.

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

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

بازگشت

Overflow Menu — یک منوی سرریز خالی.

`new Overflow Menu Item()`

یک Overflow Menu Item جدید ایجاد می‌کند.

برای برنامه‌های چت گوگل موجود است. در پیش‌نمایش توسعه‌دهندگان برای افزونه‌های 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 Menu Item - یک آیتم منوی سرریز خالی.

`new Selection Input()`

یک Selection Input جدید ایجاد می‌کند.

بازگشت

Selection Input — یک ورودی انتخاب خالی.

`new Suggestions()`

یک Suggestions جدید ایجاد می‌کند.

بازگشت

Suggestions — یک پیشنهاد خالی.

`new Suggestions Response Builder()`

یک Suggestions Response Builder جدید ایجاد می‌کند.

بازگشت

Suggestions Response Builder — یک سازنده خالی SuggestionsResponse.

`new Switch()`

یک Switch جدید ایجاد می‌کند.

بازگشت

Switch — یک سوئیچ خالی.

`new Text Button()`

یک Text Button جدید ایجاد می‌کند.

بازگشت

Text Button — یک دکمه متنی خالی.

`new Text Input()`

یک Text Input جدید ایجاد می‌کند.

بازگشت

Text Input — یک ورودی متن خالی.

`new Text Paragraph()`

یک Text Paragraph جدید ایجاد می‌کند.

بازگشت

Text Paragraph — یک پاراگراف متنی خالی.

`new Time Picker()`

یک Time Picker جدید ایجاد می‌کند.

بازگشت

Time Picker — یک انتخابگر زمان خالی.

`new Universal Action Response Builder()`

یک Universal Action Response Builder جدید ایجاد می‌کند.

بازگشت

Universal Action Response Builder - یک سازنده خالی UniversalActionResponse.

`new Update Draft Action Response Builder()`

یک Update Draft Action Response Builder جدید ایجاد می‌کند.

بازگشت

Update Draft Action Response Builder - یک سازنده‌ی پاسخِ خالیِ UpdateDraftActionResponse.

`new Update Draft Bcc Recipients Action()`

یک Update Draft Bcc Recipients Action ایجاد می‌کند؛

بازگشت

Update Draft Bcc Recipients Action — یک اقدام خالی برای UpdateDraftBccRecipientsAction.

`new Update Draft Body Action()`

یک Update Draft Body Action ایجاد می‌کند.

بازگشت

Update Draft Body Action — یک اقدام خالیِ به‌روزرسانی بدنه‌ی پیش‌نویس.

`new Update Draft Cc Recipients Action()`

یک Update Draft Cc Recipients Action ایجاد می‌کند.

بازگشت

Update Draft Cc Recipients Action - یک اقدام خالی UpdateDraftCcRecipientsAction.

`new Update Draft Subject Action()`

یک Update Draft Subject Action جدید ایجاد می‌کند.

بازگشت

Update Draft Subject Action — یک اقدام موضوع پیش‌نمایش خالی.

`new Update Draft To Recipients Action()`

یک Update Draft To Recipients Action ایجاد می‌کند.

بازگشت

Update Draft To Recipients Action - یک اقدام خالی UpdateDraftToRecipients.

`new Validation()`

یک Validation جدید ایجاد می‌کند.

برای برنامه‌های Google Chat و افزونه‌های Google Workspace موجود است.

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

بازگشت

Validation — یک اعتبارسنجی خالی.

در زیر نمونه‌ای از کارت افزونه‌ها را مشاهده می‌کنید.

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

نمونه برای کارت برنامه چت.

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 Type`	`Border Type`	شمارش `Border Type` .
`Chip List Layout`	`Chip List Layout`	شمارش `Chip List Layout` .
`Composed Email Type`	`Composed Email Type`	شمارش `Composed Email Type` .
`Content Type`	`Content Type`	شمارش `Content Type` .
`Expression Data Action Type`	`Expression Data Action Type`	شمارش `Expression Data Action Type` .
`Expression Data Condition Type`	`Expression Data Condition Type`	شمارش `Expression Data Condition Type` .
`Grid Item Layout`	`Grid Item Layout`	شمارش `Grid Item Layout` .
`Horizontal Alignment`	`Horizontal Alignment`	شمارش `Horizontal Alignment` .
`Icon`	`Icon`	شمارش `Icon` .
`Image Button Style`	`Image Button Style`	شمارش `Image Button Style` .
`Image Crop Type`	`Image Crop Type`	شمارش `Image Crop Type` .
`Image Style`	`Image Style`	شمارش `Image Style` .
`Input Type`	`Input Type`	شمارش `Input Type` .
`Load Indicator`	`Load Indicator`	شمارش `Load Indicator` .
`On Close`	`On Close`	شمارش `On Close` .
`Open As`	`Open As`	شمارش `Open As` .
`Selection Input Type`	`Selection Input Type`	شمارش `Selection Input Type` .
`Text Button Style`	`Text Button Style`	شمارش `Text Button Style` .
`Update Draft Body Type`	`Update Draft Body Type`	شمارش `Update Draft Body Type` .
`Visibility`	`Visibility`	شمارش `Visibility` .
`Workflow Data Source Type`	`Workflow Data Source Type`	شمارش `Workflow Data Source Type` .

روش‌ها

روش	نوع بازگشتی	شرح مختصر
`new Action()`	`Action`	یک `Action` جدید ایجاد می‌کند.
`new Action Response Builder()`	`Action Response Builder`	یک `Action Response Builder` جدید ایجاد می‌کند.
`new Action Status()`	`Action Status`	یک `Action Status` جدید ایجاد می‌کند.
`new Attachment()`	`Attachment`	یک `Attachment` جدید ایجاد می‌کند.
`new Authorization Action()`	`Authorization Action`	یک `Authorization Action` جدید ایجاد می‌کند.
`new Authorization Exception()`	`Authorization Exception`	یک `Authorization Exception` جدید ایجاد می‌کند.
`new Border Style()`	`Border Style`	یک `Border Style` جدید ایجاد می‌کند.
`new Button Set()`	`Button Set`	یک `Button Set` جدید ایجاد می‌کند.
`new Calendar Event Action Response Builder()`	`Calendar Event Action Response Builder`	یک `Calendar Event Action Response Builder` جدید ایجاد می‌کند.
`new Card Action()`	`Card Action`	یک `Card Action` جدید ایجاد می‌کند.
`new Card Builder()`	`Card Builder`	یک سازنده کارت جدید ایجاد می‌کند.
`new Card Header()`	`Card Header`	یک `Card Header` جدید ایجاد می‌کند.
`new Card Section()`	`Card Section`	یک `Card Section` جدید ایجاد می‌کند.
`new Card With Id()`	`Card With Id`	یک `Card With Id` ایجاد می‌کند.
`new Carousel()`	`Carousel`	یک `Carousel` ایجاد می‌کند.
`new Carousel Card()`	`Carousel Card`	یک `Carousel Card` جدید ایجاد می‌کند.
`new Chat Action Response()`	`Chat Action Response`	یک `Chat Action Response` ایجاد می‌کند.
`new Chat Response Builder()`	`Chat Response Builder`	یک `Chat Response Builder` جدید ایجاد می‌کند.
`new Chip()`	`Chip`	یک `Chip` جدید ایجاد می‌کند.
`new Chip List()`	`Chip List`	یک `Chip List` جدید ایجاد می‌کند.
`new Collapse Control()`	`Collapse Control`	یک `Collapse Control` جدید ایجاد می‌کند.
`new Column()`	`Column`	یک `Column` جدید ایجاد می‌کند.
`new Columns()`	`Columns`	یک مجموعه جدید از `Columns` ایجاد می‌کند.
`new Compose Action Response Builder()`	`Compose Action Response Builder`	یک `Compose Action Response Builder` جدید ایجاد می‌کند.
`new Date Picker()`	`Date Picker`	یک `Date Picker` جدید ایجاد می‌کند.
`new Date Time Picker()`	`Date Time Picker`	یک `Date Time Picker` جدید ایجاد می‌کند.
`new Decorated Text()`	`Decorated Text`	یک `Decorated Text` جدید ایجاد می‌کند.
`new Dialog()`	`Dialog`	یک `Dialog` جدید ایجاد می‌کند.
`new Dialog Action()`	`Dialog Action`	یک `Dialog Action` جدید ایجاد می‌کند.
`new Divider()`	`Divider`	یک `Divider` جدید ایجاد می‌کند.
`new Drive Items Selected Action Response Builder()`	`Drive Items Selected Action Response Builder`	یک `Drive Items Selected Action Response Builder` جدید ایجاد می‌کند.
`new Editor File Scope Action Response Builder()`	`Editor File Scope Action Response Builder`	یک `Editor File Scope Action Response Builder` ایجاد می‌کند.
`new Fixed Footer()`	`Fixed Footer`	یک `Fixed Footer` جدید ایجاد می‌کند.
`new Grid()`	`Grid`	یک `Grid` جدید ایجاد می‌کند.
`new Grid Item()`	`Grid Item`	یک `Grid Item` جدید ایجاد می‌کند.
`new Host App Data Source()`	`Host App Data Source`	یک `Host App Data Source` جدید ایجاد می‌کند و یک `Host App Data Source` خالی برمی‌گرداند.
`new Icon Image()`	`Icon Image`	یک `Icon Image` جدید ایجاد می‌کند.
`new Image()`	`Image`	یک `Image` جدید ایجاد می‌کند.
`new Image Button()`	`Image Button`	یک `Image Button` جدید ایجاد می‌کند.
`new Image Component()`	`Image Component`	یک `Image Component` جدید ایجاد می‌کند.
`new Image Crop Style()`	`Image Crop Style`	یک `Image Crop Style` جدید ایجاد می‌کند.
`new Key Value()`	`Key Value`	یک `Key Value` جدید ایجاد می‌کند.
`new Link Preview()`	`Link Preview`	یک `Link Preview` جدید ایجاد می‌کند.
`new Material Icon()`	`Material Icon`	یک `Material Icon` جدید ایجاد می‌کند.
`new Navigation()`	`Navigation`	یک `Navigation` جدید ایجاد می‌کند.
`new Notification()`	`Notification`	یک `Notification` جدید ایجاد می‌کند.
`new Open Link()`	`Open Link`	یک `Open Link` جدید ایجاد می‌کند.
`new Overflow Menu()`	`Overflow Menu`	یک `Overflow Menu` جدید ایجاد می‌کند.
`new Overflow Menu Item()`	`Overflow Menu Item`	یک `Overflow Menu Item` جدید ایجاد می‌کند.
`new Selection Input()`	`Selection Input`	یک `Selection Input` جدید ایجاد می‌کند.
`new Suggestions()`	`Suggestions`	یک `Suggestions` جدید ایجاد می‌کند.
`new Suggestions Response Builder()`	`Suggestions Response Builder`	یک `Suggestions Response Builder` جدید ایجاد می‌کند.
`new Switch()`	`Switch`	یک `Switch` جدید ایجاد می‌کند.
`new Text Button()`	`Text Button`	یک `Text Button` جدید ایجاد می‌کند.
`new Text Input()`	`Text Input`	یک `Text Input` جدید ایجاد می‌کند.
`new Text Paragraph()`	`Text Paragraph`	یک `Text Paragraph` جدید ایجاد می‌کند.
`new Time Picker()`	`Time Picker`	یک `Time Picker` جدید ایجاد می‌کند.
`new Universal Action Response Builder()`	`Universal Action Response Builder`	یک `Universal Action Response Builder` جدید ایجاد می‌کند.
`new Update Draft Action Response Builder()`	`Update Draft Action Response Builder`	یک `Update Draft Action Response Builder` جدید ایجاد می‌کند.
`new Update Draft Bcc Recipients Action()`	`Update Draft Bcc Recipients Action`	یک `Update Draft Bcc Recipients Action` ایجاد می‌کند؛
`new Update Draft Body Action()`	`Update Draft Body Action`	یک `Update Draft Body Action` ایجاد می‌کند.
`new Update Draft Cc Recipients Action()`	`Update Draft Cc Recipients Action`	یک `Update Draft Cc Recipients Action` ایجاد می‌کند.
`new Update Draft Subject Action()`	`Update Draft Subject Action`	یک `Update Draft Subject Action` جدید ایجاد می‌کند.
`new Update Draft To Recipients Action()`	`Update Draft To Recipients Action`	یک `Update Draft To Recipients Action` ایجاد می‌کند.
`new Validation()`	`Validation`	یک `Validation` جدید ایجاد می‌کند.

مستندات دقیق

`new Action()`

یک Action جدید ایجاد می‌کند.

بازگشت

Action — یک اکشن خالی.

`new Action Response Builder()`

یک Action Response Builder جدید ایجاد می‌کند.

بازگشت

Action Response Builder — یک سازنده‌ی اکشن‌ریسپانس خالی.

`new Action Status()`

یک Action Status جدید ایجاد می‌کند.

فقط برای برنامه‌های Google Chat در دسترس است. برای افزونه‌های Google Workspace در دسترس نیست.

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

بازگشت

Action Status — یک وضعیت اقدام خالی.

`new Attachment()`

یک Attachment جدید ایجاد می‌کند.

بازگشت

Attachment — یک پیوست خالی.

`new Authorization Action()`

یک Authorization Action جدید ایجاد می‌کند.

بازگشت

Authorization Action — یک اقدام مجوزدهی خالی.

`new Authorization Exception()`

یک Authorization Exception جدید ایجاد می‌کند.

بازگشت

Authorization Exception - یک استثنای مجوز خالی.

`new Border Style()`

یک Border Style جدید ایجاد می‌کند.

بازگشت

Border Style - یک BorderStyle خالی.

`new Button Set()`

یک Button Set جدید ایجاد می‌کند.

بازگشت

Button Set - یک مجموعه دکمه خالی.

`new Calendar Event Action Response Builder()`

یک Calendar Event Action Response Builder جدید ایجاد می‌کند.

بازگشت

Calendar Event Action Response Builder — یک Calendar Event Action Response Builder خالی.

`new Card Action()`

یک Card Action جدید ایجاد می‌کند.

بازگشت

Card Action — یک اکشن کارت خالی.

`new Card Builder()`

یک سازنده کارت جدید ایجاد می‌کند.

بازگشت

Card Builder — یک سازنده کارت خالی.

`new Card Header()`

یک Card Header جدید ایجاد می‌کند.

بازگشت

Card Header — یک سربرگ کارت خالی.

`new Card Section()`

یک Card Section جدید ایجاد می‌کند.

بازگشت

Card Section — یک بخش کارت خالی.

`new Card With Id()`

فقط برای برنامه‌های 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 With Id — یک Card With Id .

`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 Card جدید ایجاد می‌کند.

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

بازگشت

Carousel Card - یک چیپ خالی.

`new Chat Action Response()`

یک Chat Action Response ایجاد می‌کند.

فقط برای برنامه‌های 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);

بازگشت

Chat Action Response — یک Chat Action Response خالی.

`new Chat Response Builder()`

یک Chat Response Builder جدید ایجاد می‌کند.

فقط برای برنامه‌های 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 Response Builder - یک سازنده پاسخ چت خالی.

`new Chip()`

یک Chip جدید ایجاد می‌کند.

برای برنامه‌های چت گوگل موجود است. در پیش‌نمایش توسعه‌دهندگان برای افزونه‌های Google Workspace.

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

بازگشت

Chip — یک چیپ خالی.

`new Chip List()`

یک Chip List جدید ایجاد می‌کند.

برای برنامه‌های چت گوگل موجود است. در پیش‌نمایش توسعه‌دهندگان برای افزونه‌های Google Workspace.

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

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

بازگشت

Chip List - یک فهرست تراشه خالی.

`new Collapse Control()`

یک Collapse Control جدید ایجاد می‌کند.

برای برنامه‌های چت گوگل موجود است. در پیش‌نمایش توسعه‌دهندگان برای افزونه‌های Google Workspace.

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

بازگشت

Collapse Control - یک 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 Action Response Builder جدید ایجاد می‌کند.

بازگشت

Compose Action Response Builder — یک سازنده‌ی خالی ComposeActionResponse.

`new Date Picker()`

یک Date Picker جدید ایجاد می‌کند.

بازگشت

Date Picker - یک انتخابگر تاریخ خالی.

`new Date Time Picker()`

یک Date Time Picker جدید ایجاد می‌کند.

بازگشت

Date Time Picker - یک انتخابگر تاریخ و زمان خالی.

`new Decorated Text()`

یک Decorated Text جدید ایجاد می‌کند.

بازگشت

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

بازگشت

Dialog — یک Dialog خالی.

`new Dialog Action()`

یک Dialog Action جدید ایجاد می‌کند.

فقط برای برنامه‌های 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 Action — یک Dialog Action خالی.

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

یک Drive Items Selected Action Response Builder جدید ایجاد می‌کند.

بازگشت

Drive Items Selected Action Response Builder — یک Drive Items Selected Action Response Builder خالی.

`new Editor File Scope Action Response Builder()`

یک Editor File Scope Action Response Builder ایجاد می‌کند.

بازگشت

Editor File Scope Action Response Builder — یک Editor File Scope Action Response Builder خالی.

`new Fixed Footer()`

یک Fixed Footer جدید ایجاد می‌کند.

بازگشت

Fixed Footer — یک FixedFooter خالی.

`new Grid()`

یک Grid جدید ایجاد می‌کند.

بازگشت

Grid - یک شبکه خالی.

`new Grid Item()`

یک Grid Item جدید ایجاد می‌کند.

بازگشت

Grid Item - یک آیتم شبکه‌ای خالی.

`new Host App Data Source()`

یک Host App Data Source جدید ایجاد می‌کند و یک Host App Data Source خالی برمی‌گرداند.

بازگشت

Host App Data Source

`new Icon Image()`

یک Icon Image جدید ایجاد می‌کند.

بازگشت

Icon Image — یک تصویر آیکون خالی.

`new Image()`

یک Image جدید ایجاد می‌کند.

بازگشت

Image — یک تصویر خالی.

`new Image Button()`

یک Image Button جدید ایجاد می‌کند.

بازگشت

Image Button - یک دکمه تصویر خالی.

`new Image Component()`

یک Image Component جدید ایجاد می‌کند.

بازگشت

Image Component - یک کامپوننت تصویر خالی.

`new Image Crop Style()`

یک Image Crop Style جدید ایجاد می‌کند.

بازگشت

Image Crop Style — یک ImageCropStyle خالی.

`new Key Value()`

یک Key Value جدید ایجاد می‌کند.

بازگشت

Key Value - یک مقدار کلید خالی.

`new Link Preview()`

یک Link Preview جدید ایجاد می‌کند.

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 Preview — یک پیش‌نمایش لینک خالی.

`new Material Icon()`

یک Material Icon جدید ایجاد می‌کند.

برای برنامه‌های 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 Icon — یک آیکون متریال خالی.

`new Navigation()`

یک Navigation جدید ایجاد می‌کند.

بازگشت

Navigation — یک ناوبری خالی.

`new Notification()`

یک Notification جدید ایجاد می‌کند.

بازگشت

Notification — یک اعلان خالی.

`new Open Link()`

یک Open Link جدید ایجاد می‌کند.

بازگشت

Open Link - یک پیوند باز خالی.

`new Overflow Menu()`

یک Overflow Menu جدید ایجاد می‌کند.

برای برنامه‌های چت گوگل موجود است. در پیش‌نمایش توسعه‌دهندگان برای افزونه‌های Google Workspace.

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

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

بازگشت

Overflow Menu — یک منوی سرریز خالی.

`new Overflow Menu Item()`

یک Overflow Menu Item جدید ایجاد می‌کند.

برای برنامه‌های چت گوگل موجود است. در پیش‌نمایش توسعه‌دهندگان برای افزونه‌های 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 Menu Item - یک آیتم منوی سرریز خالی.

`new Selection Input()`

یک Selection Input جدید ایجاد می‌کند.

بازگشت

Selection Input — یک ورودی انتخاب خالی.

`new Suggestions()`

یک Suggestions جدید ایجاد می‌کند.

بازگشت

Suggestions — یک پیشنهاد خالی.

`new Suggestions Response Builder()`

یک Suggestions Response Builder جدید ایجاد می‌کند.

بازگشت

Suggestions Response Builder — یک سازنده خالی SuggestionsResponse.

`new Switch()`

یک Switch جدید ایجاد می‌کند.

بازگشت

Switch — یک سوئیچ خالی.

`new Text Button()`

یک Text Button جدید ایجاد می‌کند.

بازگشت

Text Button — یک دکمه متنی خالی.

`new Text Input()`

یک Text Input جدید ایجاد می‌کند.

بازگشت

Text Input — یک ورودی متن خالی.

`new Text Paragraph()`

یک Text Paragraph جدید ایجاد می‌کند.

بازگشت

Text Paragraph — یک پاراگراف متنی خالی.

`new Time Picker()`

یک Time Picker جدید ایجاد می‌کند.

بازگشت

Time Picker — یک انتخابگر زمان خالی.

`new Universal Action Response Builder()`

یک Universal Action Response Builder جدید ایجاد می‌کند.

بازگشت

Universal Action Response Builder - یک سازنده خالی UniversalActionResponse.

`new Update Draft Action Response Builder()`

یک Update Draft Action Response Builder جدید ایجاد می‌کند.

بازگشت

Update Draft Action Response Builder - یک سازنده‌ی پاسخِ خالیِ UpdateDraftActionResponse.

`new Update Draft Bcc Recipients Action()`

یک Update Draft Bcc Recipients Action ایجاد می‌کند؛

بازگشت

Update Draft Bcc Recipients Action — یک اقدام خالی برای UpdateDraftBccRecipientsAction.

`new Update Draft Body Action()`

یک Update Draft Body Action ایجاد می‌کند.

بازگشت

Update Draft Body Action — یک اقدام خالیِ به‌روزرسانی بدنه‌ی پیش‌نویس.

`new Update Draft Cc Recipients Action()`

یک Update Draft Cc Recipients Action ایجاد می‌کند.

بازگشت

Update Draft Cc Recipients Action - یک اقدام خالی UpdateDraftCcRecipientsAction.

`new Update Draft Subject Action()`

یک Update Draft Subject Action جدید ایجاد می‌کند.

بازگشت

Update Draft Subject Action — یک اقدام موضوع پیش‌نمایش خالی.

`new Update Draft To Recipients Action()`

یک Update Draft To Recipients Action ایجاد می‌کند.

بازگشت

Update Draft To Recipients Action - یک اقدام خالی UpdateDraftToRecipients.

`new Validation()`

یک Validation جدید ایجاد می‌کند.

برای برنامه‌های Google Chat و افزونه‌های Google Workspace موجود است.

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

بازگشت

Validation — یک اعتبارسنجی خالی.

Class CardService با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

خواص

روش‌ها

مستندات دقیق

new Action()

بازگشت

new Action Response Builder()

بازگشت

new Action Status()

بازگشت

new Attachment()

بازگشت

new Authorization Action()

بازگشت

new Authorization Exception()

بازگشت

new Border Style()

بازگشت

new Button Set()

بازگشت

new Calendar Event Action Response Builder()

بازگشت

new Card Action()

بازگشت

new Card Builder()

بازگشت

new Card Header()

بازگشت

new Card Section()

بازگشت

new Card With Id()

بازگشت

new Carousel()

بازگشت

new Carousel Card()

بازگشت

new Chat Action Response()

بازگشت

new Chat Response Builder()

بازگشت

new Chip()

بازگشت

new Chip List()

بازگشت

new Collapse Control()

بازگشت

new Column()

بازگشت

new Columns()

بازگشت

new Compose Action Response Builder()

بازگشت

new Date Picker()

بازگشت

new Date Time Picker()

بازگشت

new Decorated Text()

بازگشت

new Dialog()

بازگشت

new Dialog Action()

بازگشت

new Divider()

بازگشت

new Drive Items Selected Action Response Builder()

بازگشت

new Editor File Scope Action Response Builder()

بازگشت

new Fixed Footer()

بازگشت

new Grid()

بازگشت

new Grid Item()

بازگشت

new Host App Data Source()

بازگشت

new Icon Image()

بازگشت

new Image()

بازگشت

Class CardService

`new Action()`

`new Action Response Builder()`

`new Action Status()`

`new Attachment()`

`new Authorization Action()`

`new Authorization Exception()`

`new Border Style()`

`new Button Set()`

`new Calendar Event Action Response Builder()`

`new Card Action()`

`new Card Builder()`

`new Card Header()`

`new Card Section()`

`new Card With Id()`

`new Carousel()`

`new Carousel Card()`

`new Chat Action Response()`

`new Chat Response Builder()`

`new Chip()`

`new Chip List()`

`new Collapse Control()`

`new Column()`

`new Columns()`

`new Compose Action Response Builder()`

`new Date Picker()`

`new Date Time Picker()`

`new Decorated Text()`

`new Dialog()`

`new Dialog Action()`

`new Divider()`

`new Drive Items Selected Action Response Builder()`

`new Editor File Scope Action Response Builder()`

`new Fixed Footer()`

`new Grid()`

`new Grid Item()`

`new Host App Data Source()`

`new Icon Image()`

`new Image()`

`new Image Button()`

`new Image Component()`

`new Image Crop Style()`

`new Key Value()`

`new Link Preview()`

`new Material Icon()`

`new Navigation()`

`new Notification()`

`new Open Link()`

`new Overflow Menu()`

`new Overflow Menu Item()`

`new Selection Input()`

`new Suggestions()`

`new Suggestions Response Builder()`

`new Switch()`

`new Text Button()`

`new Text Input()`

`new Text Paragraph()`

`new Time Picker()`

`new Universal Action Response Builder()`

`new Update Draft Action Response Builder()`

`new Update Draft Bcc Recipients Action()`

`new Update Draft Body Action()`

`new Update Draft Cc Recipients Action()`

`new Update Draft Subject Action()`

`new Update Draft To Recipients Action()`

`new Validation()`

`new Action()`

`new Action Response Builder()`

`new Action Status()`

`new Attachment()`

`new Authorization Action()`

`new Authorization Exception()`

`new Border Style()`