Only available for Google Chat apps. Not available for Google Workspace add-ons.
constcardSection=CardService.newCardSection();cardSection.addWidget(CardService.newTextParagraph().setText('This is a text paragraph widget.'),);constcard=CardService.newCardBuilder().setName('Card name').setHeader(CardService.newCardHeader().setTitle('Card title')).addSection(cardSection).build();constcardWithId=CardService.newCardWithId().setCardId('card_id').setCard(card);constchatResponse=CardService.newChatResponseBuilder().addCardsV2(cardWithId).setText('Example text').build();
Sets the card field of the message. This is used to send a card in a Google Chat message. Each
card is associated with a unique id,CardWithIdobject should be built and be used with
this method.
constcardSection=CardService.newCardSection();cardSection.addWidget(CardService.newTextParagraph().setText('This is a text paragraph widget.'),);constcard=CardService.newCardBuilder().setHeader(CardService.newCardHeader().setTitle('Card title')).addSection(cardSection).build();constcardWithId=CardService.newCardWithId().setCardId('card_id').setCard(card);constchatResponse=CardService.newChatResponseBuilder().addCardsV2(cardWithId).build();
// Build the card.constcard=CardService.newCardBuilder().setHeader(CardService.newCardHeader().setTitle('card title')).build();// Creates the dialog.constdialog=CardService.newDialog().setBody(card);// Creates the dialog action.constdialogAction=CardService.newDialogAction().setDialog(dialog);// Creates the action response and sets the type to DIALOG.constactionResponse=CardService.newChatActionResponse().setDialogAction(dialogAction).setResponseType(CardService.Type.DIALOG);// Creates the Chat response and sets the action response.constchatResponse=CardService.newChatResponseBuilder().setActionResponse(actionResponse).build();
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-01-30 UTC."],[[["\u003cp\u003e\u003ccode\u003eChatResponseBuilder\u003c/code\u003e constructs responses for Google Chat apps, enabling the inclusion of cards, text, and actions within messages.\u003c/p\u003e\n"],["\u003cp\u003eIt offers methods like \u003ccode\u003eaddCardsV2\u003c/code\u003e, \u003ccode\u003esetText\u003c/code\u003e, and \u003ccode\u003esetActionResponse\u003c/code\u003e to build comprehensive responses.\u003c/p\u003e\n"],["\u003cp\u003eEach method allows for chaining, facilitating a fluent and concise approach to building responses.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003ebuild()\u003c/code\u003e finalizes the response and returns a \u003ccode\u003eChatResponse\u003c/code\u003e object ready for delivery.\u003c/p\u003e\n"],["\u003cp\u003eThis builder is exclusively available for Google Chat apps and not for Google Workspace Add-ons.\u003c/p\u003e\n"]]],["The `ChatResponseBuilder` constructs `ChatResponse` objects for Google Chat apps. Key actions include: `addCardsV2(cardWithId)` to send cards with unique IDs, `build()` to finalize and validate the response, `setActionResponse(actionResponse)` to handle dialog actions, and `setText(text)` to include message text. Each method returns the `ChatResponseBuilder` object to enable chaining. It is crucial to notice that the object built is for chat applications only.\n"],null,["# Class ChatResponseBuilder\n\nChatResponseBuilder\n\nA builder for [ChatResponse](/apps-script/reference/card-service/chat-response) objects.\n\nOnly available for Google Chat apps. Not available for Google Workspace add-ons.\n\n```javascript\nconst cardSection = CardService.newCardSection();\ncardSection.addWidget(\n CardService.newTextParagraph().setText('This is a text paragraph widget.'),\n);\n\nconst card = CardService.newCardBuilder()\n .setName('Card name')\n .setHeader(CardService.newCardHeader().setTitle('Card title'))\n .addSection(cardSection)\n .build();\n\nconst cardWithId =\n CardService.newCardWithId().setCardId('card_id').setCard(card);\n\nconst chatResponse = CardService.newChatResponseBuilder()\n .addCardsV2(cardWithId)\n .setText('Example text')\n .build();\n``` \n\n### Methods\n\n| Method | Return type | Brief description |\n|-----------------------------------------------------------------------------|-------------------------------------------------------------------|------------------------------------------------------|\n| [addCardsV2(cardWithId)](#addCardsV2(CardWithId)) | [ChatResponseBuilder](#) | Sets the card field of the message. |\n| [build()](#build()) | [ChatResponse](/apps-script/reference/card-service/chat-response) | Builds the current action response and validates it. |\n| [setActionResponse(actionResponse)](#setActionResponse(ChatActionResponse)) | [ChatResponseBuilder](#) | Sets the action response field of the message. |\n| [setText(text)](#setText(String)) | [ChatResponseBuilder](#) | Sets the text of the Chat message. |\n\nDetailed documentation\n----------------------\n\n### `add``Cards``V2(cardWithId)`\n\nSets the card field of the message. This is used to send a card in a Google Chat message. Each\ncard is associated with a unique id, [CardWithId](/apps-script/reference/card-service/card-with-id) object should be built and be used with\nthis method.\n\n```javascript\nconst cardSection = CardService.newCardSection();\ncardSection.addWidget(\n CardService.newTextParagraph().setText('This is a text paragraph widget.'),\n);\n\nconst card = CardService.newCardBuilder()\n .setHeader(CardService.newCardHeader().setTitle('Card title'))\n .addSection(cardSection)\n .build();\n\nconst cardWithId =\n CardService.newCardWithId().setCardId('card_id').setCard(card);\n\nconst chatResponse =\n CardService.newChatResponseBuilder().addCardsV2(cardWithId).build();\n```\n\n#### Parameters\n\n| Name | Type | Description |\n|------------------|----------------------------------------------------------------|----------------------------------------------------------------------------|\n| `card``With``Id` | [CardWithId](/apps-script/reference/card-service/card-with-id) | The [CardWithId](/apps-script/reference/card-service/card-with-id) to use. |\n\n#### Return\n\n\n[ChatResponseBuilder](#) --- This object, for chaining.\n\n*** ** * ** ***\n\n### `build()`\n\nBuilds the current action response and validates it.\n\n#### Return\n\n\n[ChatResponse](/apps-script/reference/card-service/chat-response) --- A validated ChatResponse.\n\n*** ** * ** ***\n\n### `set``Action``Response(actionResponse)`\n\nSets the action response field of the message.\n\n```javascript\n// Build the card.\nconst card = CardService.newCardBuilder()\n .setHeader(CardService.newCardHeader().setTitle('card title'))\n .build();\n\n// Creates the dialog.\nconst dialog = CardService.newDialog().setBody(card);\n\n// Creates the dialog action.\nconst dialogAction = CardService.newDialogAction().setDialog(dialog);\n\n// Creates the action response and sets the type to DIALOG.\nconst actionResponse = CardService.newChatActionResponse()\n .setDialogAction(dialogAction)\n .setResponseType(CardService.Type.DIALOG);\n\n// Creates the Chat response and sets the action response.\nconst chatResponse = CardService.newChatResponseBuilder()\n .setActionResponse(actionResponse)\n .build();\n```\n\n#### Parameters\n\n| Name | Type | Description |\n|--------------------|--------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|\n| `action``Response` | [ChatActionResponse](/apps-script/reference/card-service/chat-action-response) | The [ChatActionResponse](/apps-script/reference/card-service/chat-action-response) to use. |\n\n#### Return\n\n\n[ChatResponseBuilder](#) --- This object, for chaining.\n\n*** ** * ** ***\n\n### `set``Text(text)`\n\nSets the text of the Chat message.\n\n```javascript\nconst chatResponse =\n CardService.newChatResponseBuilder().setText('Example text').build();\n```\n\n#### Parameters\n\n| Name | Type | Description |\n|--------|----------|------------------|\n| `text` | `String` | The text to use. |\n\n#### Return\n\n\n[ChatResponseBuilder](#) --- This object, for chaining."]]
