이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Class CardService

CardService는 Google Workspace 부가기능과 같은 다양한 Google 확장 제품에서 사용되는 일반 카드를 만드는 기능을 제공합니다.

다음은 부가기능 카드의 샘플입니다.

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

채팅 앱 카드의 샘플입니다.

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` 열거형입니다.
`ComposedEmailType`	`ComposedEmailType`	`ComposedEmailType` 열거형입니다.
`ContentType`	`ContentType`	`ContentType` 열거형입니다.
`GridItemLayout`	`GridItemLayout`	`GridItemLayout` 열거형입니다.
`HorizontalAlignment`	`HorizontalAlignment`	`HorizontalAlignment` 열거형입니다.
`Icon`	`Icon`	`Icon` 열거형입니다.
`ImageCropType`	`ImageCropType`	`ImageCropType` 열거형입니다.
`ImageStyle`	`ImageStyle`	`ImageStyle` 열거형입니다.
`LoadIndicator`	`LoadIndicator`	`LoadIndicator` 열거형입니다.
`OnClose`	`OnClose`	`OnClose` 열거형입니다.
`OpenAs`	`OpenAs`	`OpenAs` 열거형입니다.
`SelectionInputType`	`SelectionInputType`	`SelectionInputType` 열거형입니다.
`TextButtonStyle`	`TextButtonStyle`	`TextButtonStyle` 열거형입니다.
`UpdateDraftBodyType`	`UpdateDraftBodyType`	`UpdateDraftBodyType` 열거형입니다.

방법

메서드	반환 유형	간략한 설명
`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`	새 `CardBuilder`를 만듭니다.
`newCardHeader()`	`CardHeader`	새 `CardHeader`를 만듭니다.
`newCardSection()`	`CardSection`	새 `CardSection`를 만듭니다.
`newCardWithId()`	`CardWithId`	새 `CardWithId`를 만듭니다.
`newChatActionResponse()`	`ChatActionResponse`	새 `ChatActionResponse`를 만듭니다.
`newChatResponseBuilder()`	`ChatResponseBuilder`	새 `ChatResponseBuilder`를 만듭니다.
`newComposeActionResponseBuilder()`	`ComposeActionResponseBuilder`	새 `ComposeActionResponseBuilder`를 만듭니다.
`newDatePicker()`	`DatePicker`	새 `DatePicker`를 만듭니다.
`newDateTimePicker()`	`DateTimePicker`	새 `DateTimePicker`를 만듭니다.
`newDecoratedText()`	`DecoratedText`	새 `DecoratedText`를 만듭니다.
`newDialog()`	`Dialog`	새 `Dialog`를 만듭니다.
`newDialogAction()`	`DialogAction`	새 `DialogAction`를 만듭니다.
`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`를 만듭니다.
`newLinkPreview()`	`LinkPreview`	새 `LinkPreview`를 만듭니다.
`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 빌더입니다.

`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 - 빈 AuthorizationException입니다.

`newBorderStyle()`

새 BorderStyle를 만듭니다.

리턴

BorderStyle - 빈 BorderStyle입니다.

`newButtonSet()`

새 ButtonSet를 만듭니다.

리턴

ButtonSet: 빈 ButtonSet

`newCalendarEventActionResponseBuilder()`

새 CalendarEventActionResponseBuilder를 만듭니다.

리턴

CalendarEventActionResponseBuilder: 빈 CalendarEventActionResponseBuilder입니다.

`newCardAction()`

새 CardAction를 만듭니다.

리턴

CardAction - 빈 CardAction

`newCardBuilder()`

새 CardBuilder를 만듭니다.

리턴

CardBuilder - 빈 카드 빌더입니다.

`newCardHeader()`

새 CardHeader를 만듭니다.

리턴

CardHeader - 빈 CardHeader입니다.

`newCardSection()`

새 CardSection를 만듭니다.

리턴

CardSection: 빈 CardSection.

`newCardWithId()`

새 CardWithId를 만듭니다. Google Chat 메시지로 카드를 보내는 데 사용됩니다. 카드 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);

리턴

CardWithId: 빈 CardWithId입니다.

`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입니다.

`newComposeActionResponseBuilder()`

새 ComposeActionResponseBuilder를 만듭니다.

리턴

ComposeActionResponseBuilder - 빈 ComposeActionResponse 빌더입니다.

`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를 만듭니다. 다음 샘플에서는 구분선으로 구분된 2개의 단락이 있는 간단한 카드를 빌드합니다.

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 - 구분선입니다.

`newFixedFooter()`

새 FixedFooter를 만듭니다.

리턴

FixedFooter — 빈 FixedFooter입니다.

`newGrid()`

새 Grid를 만듭니다.

리턴

Grid - 빈 그리드입니다.

`newGridItem()`

새 GridItem를 만듭니다.

리턴

GridItem - 빈 GridItem입니다.

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

const linkPreview = CardService.newLinkPreview()
    .setPreviewCard(card)
    .setTitle('Smart chip title');

리턴

LinkPreview - 빈 LinkPreview입니다.

`newNavigation()`

새 Navigation를 만듭니다.

리턴

Navigation - 빈 탐색입니다.

`newNotification()`

새 Notification를 만듭니다.

리턴

Notification - 빈 알림입니다.

`newOpenLink()`

새 OpenLink를 만듭니다.

리턴

OpenLink: 빈 OpenLink입니다.

`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

`newUniversalActionResponseBuilder()`

새 UniversalActionResponseBuilder를 만듭니다.

리턴

UniversalActionResponseBuilder - 빈 UniversalActionResponse 빌더입니다.

`newUpdateDraftActionResponseBuilder()`

새 UpdateDraftActionResponseBuilder를 만듭니다.

리턴

UpdateDraftActionResponseBuilder - 빈 UpdateDraftActionResponseBuilder입니다.

`newUpdateDraftBccRecipientsAction()`

새 UpdateDraftBccRecipientsAction를 만듭니다.

리턴

UpdateDraftBccRecipientsAction - 빈 UpdateDraftBccRecipientsAction입니다.

`newUpdateDraftBodyAction()`

새 UpdateDraftBodyAction를 만듭니다.

리턴

UpdateDraftBodyAction - 빈 UpdateDraftBodyAction입니다.

`newUpdateDraftCcRecipientsAction()`

새 UpdateDraftCcRecipientsAction를 만듭니다.

리턴

UpdateDraftCcRecipientsAction - 빈 UpdateDraftCcRecipientsAction입니다.

`newUpdateDraftSubjectAction()`

새 UpdateDraftSubjectAction를 만듭니다.

리턴

UpdateDraftSubjectAction - 빈 UpdateDraftSubjectAction입니다.

`newUpdateDraftToRecipientsAction()`

새 UpdateDraftToRecipientsAction를 만듭니다.

리턴

UpdateDraftToRecipientsAction - 빈 UpdateDraftToRecipientsAction입니다.

Class CardService

속성

방법

자세한 문서

newAction()

리턴

newActionResponseBuilder()

리턴

newActionStatus()

리턴

newAttachment()

리턴

newAuthorizationAction()

리턴

newAuthorizationException()

리턴

newBorderStyle()

리턴

newButtonSet()

리턴

newCalendarEventActionResponseBuilder()

리턴

newCardAction()

리턴

newCardBuilder()

리턴

newCardHeader()

리턴

newCardSection()

리턴

newCardWithId()

리턴

newChatActionResponse()

리턴

newChatResponseBuilder()

리턴

newComposeActionResponseBuilder()

리턴

newDatePicker()

리턴

newDateTimePicker()

리턴

newDecoratedText()

리턴

newDialog()

리턴

newDialogAction()

리턴

newDivider()

리턴

newDriveItemsSelectedActionResponseBuilder()

리턴

newEditorFileScopeActionResponseBuilder()

리턴

newFixedFooter()

리턴

newGrid()

리턴

newGridItem()

리턴

newIconImage()

리턴

newImage()

리턴

newImageButton()

리턴

newImageComponent()

리턴

newImageCropStyle()

리턴

newKeyValue()

리턴

newLinkPreview()

리턴

newNavigation()

리턴

newNotification()

리턴

newOpenLink()

리턴

`newAction()`

`newActionResponseBuilder()`

`newActionStatus()`

`newAttachment()`

`newAuthorizationAction()`

`newAuthorizationException()`

`newBorderStyle()`

`newButtonSet()`

`newCalendarEventActionResponseBuilder()`

`newCardAction()`

`newCardBuilder()`

`newCardHeader()`

`newCardSection()`

`newCardWithId()`

`newChatActionResponse()`

`newChatResponseBuilder()`

`newComposeActionResponseBuilder()`

`newDatePicker()`

`newDateTimePicker()`

`newDecoratedText()`

`newDialog()`

`newDialogAction()`

`newDivider()`

`newDriveItemsSelectedActionResponseBuilder()`

`newEditorFileScopeActionResponseBuilder()`

`newFixedFooter()`

`newGrid()`

`newGridItem()`

`newIconImage()`

`newImage()`

`newImageButton()`

`newImageComponent()`

`newImageCropStyle()`

`newKeyValue()`

`newLinkPreview()`

`newNavigation()`

`newNotification()`

`newOpenLink()`

`newSelectionInput()`

`newSuggestions()`

`newSuggestionsResponseBuilder()`

`newSwitch()`

`newTextButton()`

`newTextInput()`

`newTextParagraph()`

`newTimePicker()`

`newUniversalActionResponseBuilder()`

`newUpdateDraftActionResponseBuilder()`

`newUpdateDraftBccRecipientsAction()`

`newUpdateDraftBodyAction()`

`newUpdateDraftCcRecipientsAction()`

`newUpdateDraftSubjectAction()`

`newUpdateDraftToRecipientsAction()`