Class 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');
详细文档
printJson()
输出此对象的 JSON 表示法。这仅用于调试。
返回
String
setLinkPreviewTitle(title)
设置在预览卡片上方链接预览中显示的标题。如果未设置,链接预览会显示 PreviewCard
的标头。
const linkPreview =
CardService.newLinkPreview().setLinkPreviewTitle('Link preview title');
参数
名称 | 类型 | 说明 |
title | String | 链接预览的标题。 |
返回
LinkPreview
- 此对象,用于链式调用。
setPreviewCard(previewCard)
设置用于显示第三方或非 Google 服务中链接相关信息的卡片。
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');
参数
名称 | 类型 | 说明 |
previewCard | Card | 预览卡片。 |
返回
LinkPreview
- 此对象,用于链式调用。
setTitle(title)
设置链接预览的智能条状标签中显示的标题。如果未设置,智能条状标签会显示 PreviewCard
的标头。
const linkPreview = CardService.newLinkPreview().setTitle('Smart chip title');
参数
名称 | 类型 | 说明 |
title | String | 智能条状标签的标题。 |
返回
LinkPreview
- 此对象,用于链式调用。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-26。
[null,null,["最后更新时间 (UTC):2025-07-26。"],[[["\u003cp\u003e\u003ccode\u003eLinkPreview\u003c/code\u003e is a card action that displays a preview card and smart chip within a host application.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can customize the title shown in the link preview and smart chip using \u003ccode\u003esetLinkPreviewTitle()\u003c/code\u003e and \u003ccode\u003esetTitle()\u003c/code\u003e, respectively.\u003c/p\u003e\n"],["\u003cp\u003eA preview card, created using \u003ccode\u003eCardService\u003c/code\u003e, provides detailed information about the linked content within the \u003ccode\u003eLinkPreview\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003esetPreviewCard()\u003c/code\u003e is used to attach this custom preview card to the \u003ccode\u003eLinkPreview\u003c/code\u003e action.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eprintJson()\u003c/code\u003e method is available for debugging purposes to inspect the JSON representation of the \u003ccode\u003eLinkPreview\u003c/code\u003e object.\u003c/p\u003e\n"]]],[],null,["# Class LinkPreview\n\nLinkPreview\n\nCard action that displays a link preview card and smart chip in the host app. For more\ninformation, refer to [Preview links\nwith smart chips](https://developers.google.com/apps-script/add-ons/editors/gsao/preview-links).\n\n```javascript\nconst decoratedText =\n CardService.newDecoratedText().setTopLabel('Hello').setText('Hi!');\n\nconst cardSection = CardService.newCardSection().addWidget(decoratedText);\n\nconst card = CardService.newCardBuilder().addSection(cardSection).build();\n\nconst linkPreview = CardService.newLinkPreview().setPreviewCard(card).setTitle(\n 'Smart chip title');\n``` \n\n### Methods\n\n| Method | Return type | Brief description |\n|------------------------------------------------------------|------------------|------------------------------------------------------------------------------------------------|\n| [printJson()](#printJson()) | `String` | Prints the JSON representation of this object. |\n| [setLinkPreviewTitle(title)](#setLinkPreviewTitle(String)) | [LinkPreview](#) | Sets the title that displays in the link preview above the preview card. |\n| [setPreviewCard(previewCard)](#setPreviewCard(Card)) | [LinkPreview](#) | Sets the card that displays information about a link from a third-party or non-Google service. |\n| [setTitle(title)](#setTitle(String)) | [LinkPreview](#) | Sets the title that displays in the smart chip for the link preview. |\n\nDetailed documentation\n----------------------\n\n### `print``Json()`\n\nPrints the JSON representation of this object. This is for debugging only.\n\n#### Return\n\n\n`String`\n\n*** ** * ** ***\n\n### `set``Link``Preview``Title(title)`\n\nSets the title that displays in the link preview above the preview card. If unset, the link\npreview displays the header of the `Preview``Card`.\n\n```javascript\nconst linkPreview =\n CardService.newLinkPreview().setLinkPreviewTitle('Link preview title');\n```\n\n#### Parameters\n\n| Name | Type | Description |\n|---------|----------|--------------------------------|\n| `title` | `String` | The title of the link preview. |\n\n#### Return\n\n\n[LinkPreview](#) --- This object, for chaining.\n\n*** ** * ** ***\n\n### `set``Preview``Card(previewCard)`\n\nSets the card that displays information about a link from a third-party or non-Google service.\n\n```javascript\nconst decoratedText =\n CardService.newDecoratedText().setTopLabel('Hello').setText('Hi!');\n\nconst cardSection = CardService.newCardSection().addWidget(decoratedText);\n\nconst card = CardService.newCardBuilder().addSection(cardSection).build();\n\nconst linkPreview = CardService.newLinkPreview().setPreviewCard(card).setTitle(\n 'Smart chip title');\n```\n\n#### Parameters\n\n| Name | Type | Description |\n|-----------------|--------------------------------------------------|-------------------|\n| `preview``Card` | [Card](/apps-script/reference/card-service/card) | The preview card. |\n\n#### Return\n\n\n[LinkPreview](#) --- This object, for chaining.\n\n*** ** * ** ***\n\n### `set``Title(title)`\n\nSets the title that displays in the smart chip for the link preview. If unset, the smart chip\ndisplays the header of the `Preview``Card`.\n\n```javascript\nconst linkPreview = CardService.newLinkPreview().setTitle('Smart chip title');\n```\n\n#### Parameters\n\n| Name | Type | Description |\n|---------|----------|------------------------------|\n| `title` | `String` | The title of the smart chip. |\n\n#### Return\n\n\n[LinkPreview](#) --- This object, for chaining."]]