本頁面由 Cloud Translation API 翻譯而成。

預覽 Google Chat 訊息中的連結

為避免使用者在 Google Chat 中分享連結時切換情境，您的 Chat 應用程式可以預覽連結，方法是在訊息中附加資訊卡，提供更多資訊，並讓使用者直接在 Google Chat 中採取行動。

舉例來說，假設 Google Chat 聊天室包含公司所有客服專員，以及名為 Case-y 的 Chat 應用程式。服務專員經常在 Chat 聊天室中分享客戶服務案件的連結，但每次同事都必須開啟案件連結，才能查看指派對象、狀態和主旨等詳細資料。同樣地，如果有人想接管案件或變更狀態，也需要開啟連結。

連結預覽功能可讓空間的常駐 Chat 應用程式 Case-y 在使用者分享案件連結時，附上顯示指派對象、狀態和主旨的資訊卡。服務專員可透過資訊卡上的按鈕接管案件，並直接在對話串中變更狀態。

連結預覽功能的運作方式

如果有人在訊息中加入連結，系統會顯示資訊方塊，提醒對方 Chat 應用程式可能會預覽連結。

晶片：表示 Chat 應用程式可能會預覽連結

傳送訊息後，連結會傳送到 Chat 應用程式，接著系統會產生資訊卡並附加至使用者的訊息。

即時通訊應用程式將資訊卡附加至訊息，預覽連結

除了連結外，資訊卡還會提供連結的額外資訊，包括按鈕等互動式元素。Chat 應用程式可以根據使用者互動 (例如點選按鈕) 更新隨附資訊卡。

如果使用者不想讓 Chat 應用程式在訊息中附加資訊卡來預覽連結，可以點選預覽資訊方塊上的，禁止預覽連結。使用者隨時可以點選「移除預覽」，移除附加的資訊卡。

必要條件

HTTP

可擴充 Google Chat 的 Google Workspace 外掛程式。如要建構一個，請完成 HTTP 快速入門。

Apps Script

可擴充 Google Chat 的 Google Workspace 外掛程式。如要建構一個，請完成 Apps Script 快速入門。

設定連結預覽

在 Google Cloud 控制台的 Chat 應用程式設定頁面中，將特定連結 (例如 example.com、support.example.com 和 support.example.com/cases/) 註冊為網址模式，Chat 應用程式就能預覽這些連結。

連結預覽設定選單

開啟 Google Cloud 控制台。
按一下「Google Cloud」旁邊的向下箭頭，開啟 Chat 應用程式的專案。
在搜尋欄位中輸入 Google Chat API，然後點選「Google Chat API」。
依序點選「管理」>「設定」。
在「連結預覽」下方，新增或編輯網址模式。
1. 如要為新的網址模式設定連結預覽，請按一下「新增網址模式」。
2. 如要編輯現有網址模式的設定，請按一下向下箭頭。
在「主機模式」欄位中，輸入網址模式的網域。Chat 應用程式會預覽這個網域的連結。

如要讓 Chat 應用程式預覽特定子網域 (例如 subdomain.example.com) 的連結，請加入該子網域。

如要讓 Chat 應用程式預覽整個網域的連結，請指定萬用字元，並以星號 (*) 做為子網域。舉例來說，*.example.com 符合 subdomain.example.com 和 any.number.of.subdomains.example.com。
在「路徑前置字串」欄位中，輸入要附加至主機模式網域的路徑。

如要比對主機模式網域中的所有網址，請將「路徑前置字串」留空。

舉例來說，如果主機模式為 support.example.com，如要比對在 support.example.com/cases/ 代管的案件網址，請輸入 cases/。
按一下 [完成]。
按一下 [儲存]。

現在，只要有人在包含您 Chat 應用程式的 Chat 聊天室中，傳送符合連結預覽網址模式的連結，您的應用程式就會預覽該連結。

預覽連結

為特定連結設定連結預覽功能後，Chat 應用程式就能辨識並預覽連結，方法是在連結中附加更多資訊。

在包含 Chat 應用程式的 Chat 聊天室中，如果有人傳送的訊息含有符合連結預覽網址模式的連結，Chat 應用程式就會收到含有 MessagePayload 的事件物件。在酬載中，message.matchedUrl 物件包含使用者在訊息中加入的連結：

JSON

message: {
  matchedUrl: {
    url: "https://support.example.com/cases/case123"
  },
  ... // other message attributes redacted
}

只要檢查 MESSAGE 事件酬載中是否有 matchedUrl 欄位，Chat 應用程式就能在訊息中加入預覽連結的相關資訊。Chat 應用程式可以回覆基本文字訊息或附加資訊卡。

以簡訊回覆

如要取得基本回覆，Chat 應用程式可以透過回覆連結的訊息預覽連結。這個範例會附加訊息，重複符合連結預覽網址模式的連結網址。

Node.js

node/chat/preview-link/index.js

前往 GitHub 查看

// Reply with a text message for URLs of the subdomain "text"
if (chatMessage.matchedUrl.url.includes("text.example.com")) {
  return { hostAppDataAction: { chatDataAction: { createMessageAction: { message: {
    text: 'event.chat.messagePayload.message.matchedUrl.url: ' + chatMessage.matchedUrl.url
  }}}}};
}

將 FUNCTION_URL 替換為處理按鈕點擊事件的 HTTP 端點。

Python

python/chat/preview-link/main.py

前往 GitHub 查看

# Reply with a text message for URLs of the subdomain "text"
if "text.example.com" in chatMessage.get('matchedUrl').get('url'):
  return { 'hostAppDataAction': { 'chatDataAction': { 'createMessageAction': { 'message': {
    'text': 'event.chat.messagePayload.message.matchedUrl.url: ' + chatMessage.get('matchedUrl').get('url')
  }}}}}

將 FUNCTION_URL 替換為處理按鈕點擊事件的 HTTP 端點。

Java

java/chat/preview-link/src/main/java/com/google/chat/previewLink/App.java

前往 GitHub 查看

// Reply with a text message for URLs of the subdomain "text"
if (chatMessage.at("/matchedUrl/url").asText().contains("text.example.com")) {
  return new GenericJson() {{
    put("hostAppDataAction", new GenericJson() {{
      put("chatDataAction", new GenericJson() {{
        put("createMessageAction", new GenericJson() {{
          put("message", new GenericJson() {{
            put("text", "event.chat.messagePayload.message.matchedUrl.url: " + chatMessage.at("/matchedUrl/url").asText());
          }});
        }});
      }});
    }});
  }};
}

將 FUNCTION_URL 替換為處理按鈕點擊事件的 HTTP 端點。

Apps Script

apps-script/chat/preview-link/preview-link.gs

前往 GitHub 查看

// Reply with a text message for URLs of the subdomain "text".
if (chatMessage.matchedUrl.url.includes("text.example.com")) {
  return { hostAppDataAction: { chatDataAction: { createMessageAction: { message: {
    text: 'event.chat.messagePayload.message.matchedUrl.url: ' + chatMessage.matchedUrl.url
  }}}}};
}

附加可預覽連結的資訊卡

如要將資訊卡附加至預覽連結，請傳回含有 ChatDataActionMarkup 物件的 DataActions 動作，該物件的類型為 UpdateInlinePreviewAction。

在以下範例中，Chat 應用程式會將預覽資訊卡新增至包含網址模式 support.example.com 的訊息。

即時通訊應用程式將資訊卡附加至訊息，預覽連結

Node.js

node/chat/preview-link/index.js

前往 GitHub 查看

// Attach a card to the message for URLs of the subdomain "support"
if (chatMessage.matchedUrl.url.includes("support.example.com")) {
  // A hard-coded card is used in this example. In a real-life scenario,
  // the case information would be fetched and used to build the card.
  return { hostAppDataAction: { chatDataAction: { updateInlinePreviewAction: { cardsV2: [{
    cardId: 'attachCard',
    card: {
      header: {
        title: 'Example Customer Service Case',
        subtitle: 'Case basics',
      },
      sections: [{ widgets: [
      { decoratedText: { topLabel: 'Case ID', text: 'case123'}},
      { decoratedText: { topLabel: 'Assignee', text: 'Charlie'}},
      { decoratedText: { topLabel: 'Status', text: 'Open'}},
      { decoratedText: { topLabel: 'Subject', text: 'It won\'t turn on...' }},
      { buttonList: { buttons: [{
        text: 'OPEN CASE',
        onClick: { openLink: {
          url: 'https://support.example.com/orders/case123'
        }},
      }, {
        text: 'RESOLVE CASE',
        onClick: { openLink: {
          url: 'https://support.example.com/orders/case123?resolved=y',
        }},
      }, {
        text: 'ASSIGN TO ME',
        onClick: { action: { function: FUNCTION_URL }}
      }]}}
      ]}]
    }
  }]}}}};
}

將 FUNCTION_URL 替換為處理按鈕點擊事件的 HTTP 端點。

Python

python/chat/preview-link/main.py

前往 GitHub 查看

# Attach a card to the message for URLs of the subdomain "support"
if "support.example.com" in chatMessage.get('matchedUrl').get('url'):
  # A hard-coded card is used in this example. In a real-life scenario,
  # the case information would be fetched and used to build the card.
  return { 'hostAppDataAction': { 'chatDataAction': { 'updateInlinePreviewAction': { 'cardsV2': [{
    'cardId': 'attachCard',
    'card': {
      'header': {
        'title': 'Example Customer Service Case',
        'subtitle': 'Case basics',
      },
      'sections': [{ 'widgets': [
      { 'decoratedText': { 'topLabel': 'Case ID', 'text': 'case123'}},
      { 'decoratedText': { 'topLabel': 'Assignee', 'text': 'Charlie'}},
      { 'decoratedText': { 'topLabel': 'Status', 'text': 'Open'}},
      { 'decoratedText': { 'topLabel': 'Subject', 'text': 'It won\'t turn on...' }},
      { 'buttonList': { 'buttons': [{
        'text': 'OPEN CASE',
        'onClick': { 'openLink': {
          'url': 'https://support.example.com/orders/case123'
        }},
      }, {
        'text': 'RESOLVE CASE',
        'onClick': { 'openLink': {
          'url': 'https://support.example.com/orders/case123?resolved=y',
        }},
      }, {
        'text': 'ASSIGN TO ME',
        'onClick': { 'action': { 'function': FUNCTION_URL }}
      }]}}
      ]}]
    }
  }]}}}}

將 FUNCTION_URL 替換為處理按鈕點擊事件的 HTTP 端點。

Java

java/chat/preview-link/src/main/java/com/google/chat/previewLink/App.java

前往 GitHub 查看

// Attach a card to the message for URLs of the subdomain "support"
if (chatMessage.at("/matchedUrl/url").asText().contains("support.example.com")) {
  // A hard-coded card is used in this example. In a real-life scenario,
  // the case information would be fetched and used to build the card.
  CardWithId cardV2 = new CardWithId()
    .setCardId("attachCard")
    .setCard(new GoogleAppsCardV1Card()
      .setHeader(new GoogleAppsCardV1CardHeader()
        .setTitle("Example Customer Service Case")
        .setSubtitle("Case basics"))
      .setSections(List.of(new GoogleAppsCardV1Section().setWidgets(List.of(
        new GoogleAppsCardV1Widget().setDecoratedText(new GoogleAppsCardV1DecoratedText()
          .setTopLabel("Case ID")
          .setText("case123")),
        new GoogleAppsCardV1Widget().setDecoratedText(new GoogleAppsCardV1DecoratedText()
          .setTopLabel("Assignee")
          .setText("Charlie")),
        new GoogleAppsCardV1Widget().setDecoratedText(new GoogleAppsCardV1DecoratedText()
          .setTopLabel("Status")
          .setText("Open")),
        new GoogleAppsCardV1Widget().setDecoratedText(new GoogleAppsCardV1DecoratedText()
          .setTopLabel("Subject")
          .setText("It won't turn on...")),
        new GoogleAppsCardV1Widget().setButtonList(new GoogleAppsCardV1ButtonList()
          .setButtons(List.of(
            new GoogleAppsCardV1Button()
              .setText("OPEN CASE")
            .setOnClick(new GoogleAppsCardV1OnClick()
                .setOpenLink(new GoogleAppsCardV1OpenLink()
                  .setUrl("https://support.example.com/orders/case123"))),
            new GoogleAppsCardV1Button()
              .setText("RESOLVE CASE")
            .setOnClick(new GoogleAppsCardV1OnClick()
                .setOpenLink(new GoogleAppsCardV1OpenLink()
                  .setUrl("https://support.example.com/orders/case123?resolved=y"))),
            new GoogleAppsCardV1Button()
              .setText("ASSIGN TO ME")
              .setOnClick(new GoogleAppsCardV1OnClick()
                .setAction(new GoogleAppsCardV1Action().setFunction(FUNCTION_URL)))
          ))
        )
      ))))
    );

  return new GenericJson() {{
    put("hostAppDataAction", new GenericJson() {{
      put("chatDataAction", new GenericJson() {{
        put("updateInlinePreviewAction", new GenericJson() {{
          put("cardsV2", List.of(cardV2));
        }});
      }});
    }});
  }};
}

將 FUNCTION_URL 替換為處理按鈕點擊事件的 HTTP 端點。

Apps Script

apps-script/chat/preview-link/preview-link.gs

前往 GitHub 查看

// Attach a card to the message for URLs of the subdomain "support".
if (chatMessage.matchedUrl.url.includes("support.example.com")) {
  // A hard-coded card is used in this example. In a real-life scenario,
  // the case information would be fetched and used to build the card.
  return { hostAppDataAction: { chatDataAction: { updateInlinePreviewAction: { cardsV2: [{
    cardId: 'attachCard',
    card: {
      header: {
        title: 'Example Customer Service Case',
        subtitle: 'Case summary',
      },
      sections: [{ widgets: [
      { decoratedText: { topLabel: 'Case ID', text: 'case123'}},
      { decoratedText: { topLabel: 'Assignee', text: 'Charlie'}},
      { decoratedText: { topLabel: 'Status', text: 'Open'}},
      { decoratedText: { topLabel: 'Subject', text: 'It won\'t turn on...' }},
      { buttonList: { buttons: [{
        text: 'OPEN CASE',
        onClick: { openLink: {
          url: 'https://support.example.com/orders/case123'
        }},
      }, {
        text: 'RESOLVE CASE',
        onClick: { openLink: {
          url: 'https://support.example.com/orders/case123?resolved=y',
        }},
      }, {
        text: 'ASSIGN TO ME',
        // Clicking this button triggers the execution of the function
        // "assign" from the Apps Script project.
        onClick: { action: { function: 'assign'}}
      }]}}
      ]}]
    }
  }]}}}};
}

更新連結預覽資訊卡

當使用者與連結預覽資訊卡互動時 (例如點選資訊卡上的按鈕)，Chat 應用程式可以更新資訊卡。

如要更新資訊卡，Chat 應用程式必須傳回 DataActions 動作，並搭配下列其中一個 ChatDataActionMarkup 物件：

如果使用者傳送訊息，請傳回 UpdateMessageAction 物件。
如果訊息是由 Chat 應用程式傳送，請傳回 UpdateInlinePreviewAction 物件。

如要判斷訊息傳送者，請使用事件酬載 (buttonClickedPayload) 檢查傳送者 (message.sender.type) 是否設為 HUMAN (使用者) 或 BOT (Chat 應用程式)。

以下範例說明當使用者點選「指派給我」按鈕時，即時通訊應用程式如何更新連結預覽畫面，方法是更新資訊卡的「受讓人」欄位並停用按鈕。

即時通訊應用程式預覽連結，訊息隨附的資訊卡已更新

Node.js

node/chat/preview-link/index.js

前往 GitHub 查看

/**
 * Respond to clicks by assigning and updating the card that's attached to a
 * message previewed link of the pattern "support.example.com".
 *
 * @param {Object} chatMessage The chat message object from Google Workspace Add On event.
 * @return {Object} Action response depending on the message author.
 */
function handleCardClick(chatMessage) {
  // Creates the updated card that displays "You" for the assignee
  // and that disables the button.
  //
  // A hard-coded card is used in this example. In a real-life scenario,
  // an actual assign action would be performed before building the card.
  const message = { cardsV2: [{
    cardId: 'attachCard',
    card: {
      header: {
        title: 'Example Customer Service Case',
        subtitle: 'Case basics',
      },
      sections: [{ widgets: [
        { decoratedText: { topLabel: 'Case ID', text: 'case123'}},
        // The assignee is now "You"
        { decoratedText: { topLabel: 'Assignee', text: 'You'}},
        { decoratedText: { topLabel: 'Status', text: 'Open'}},
        { decoratedText: { topLabel: 'Subject', text: 'It won\'t turn on...' }},
        { buttonList: { buttons: [{
          text: 'OPEN CASE',
          onClick: { openLink: {
            url: 'https://support.example.com/orders/case123'
          }},
        }, {
          text: 'RESOLVE CASE',
          onClick: { openLink: {
            url: 'https://support.example.com/orders/case123?resolved=y',
          }},
        }, {
          text: 'ASSIGN TO ME',
          // The button is now disabled
          disabled: true,
          onClick: { action: { function: FUNCTION_URL }}
        }]}}
      ]}]
    }
  }]};

  // Use the adequate action response type. It depends on whether the message
  // the preview link card is attached to was created by a human or a Chat app.
  if(chatMessage.sender.type === 'HUMAN') {
    return { hostAppDataAction: { chatDataAction: { updateInlinePreviewAction: message }}};
  } else {
    return { hostAppDataAction: { chatDataAction: { updateMessageAction: message }}};
  }
}

將 FUNCTION_URL 替換為處理按鈕點擊事件的 HTTP 端點。

Python

python/chat/preview-link/main.py

前往 GitHub 查看

def handle_card_click(chatMessage: dict) -> dict:
  """Respond to clicks by assigning and updating the card that's attached to a
  message previewed link of the pattern "support.example.com".

  - Reply with text messages that echo "text.example.com" link URLs in messages.
  - Attach cards to messages with "support.example.com" link URLs.

  Args:
      chatMessage (Mapping[str, Any]): The chat message object from Google Workspace Add On event.

  Returns:
      Mapping[str, Any]: Action response depending on the message author.
  """
  # Creates the updated card that displays "You" for the assignee
  # and that disables the button.
  #
  # A hard-coded card is used in this example. In a real-life scenario,
  # an actual assign action would be performed before building the card.
  message = { 'cardsV2': [{
    'cardId': 'attachCard',
    'card': {
      'header': {
        'title': 'Example Customer Service Case',
        'subtitle': 'Case basics',
      },
      'sections': [{ 'widgets': [
      { 'decoratedText': { 'topLabel': 'Case ID', 'text': 'case123'}},
      # The assignee is now "You"
      { 'decoratedText': { 'topLabel': 'Assignee', 'text': 'You'}},
      { 'decoratedText': { 'topLabel': 'Status', 'text': 'Open'}},
      { 'decoratedText': { 'topLabel': 'Subject', 'text': 'It won\'t turn on...' }},
      { 'buttonList': { 'buttons': [{
        'text': 'OPEN CASE',
        'onClick': { 'openLink': {
          'url': 'https://support.example.com/orders/case123'
        }},
      }, {
        'text': 'RESOLVE CASE',
        'onClick': { 'openLink': {
          'url': 'https://support.example.com/orders/case123?resolved=y',
        }},
      }, {
        'text': 'ASSIGN TO ME',
        # The button is now disabled
        'disabled': True,
        'onClick': { 'action': { 'function': FUNCTION_URL }}
      }]}}
      ]}]
    }
  }]}

  # Use the adequate action response type. It depends on whether the message
  # the preview link card is attached to was created by a human or a Chat app.
  if chatMessage.get('sender').get('type') == 'HUMAN':
    return { 'hostAppDataAction': { 'chatDataAction': { 'updateInlinePreviewAction': message }}}
  else:
    return { 'hostAppDataAction': { 'chatDataAction': { 'updateMessageAction': message }}}

將 FUNCTION_URL 替換為處理按鈕點擊事件的 HTTP 端點。

Java

java/chat/preview-link/src/main/java/com/google/chat/previewLink/App.java

前往 GitHub 查看

/**
 * Respond to clicks by assigning and updating the card that's attached to a
 * message previewed link of the pattern "support.example.com".
 *
 * @param chatMessage The chat message object from Google Workspace Add On event.
 * @return Action response depending on the message author.
 */
GenericJson handleCardClick(JsonNode chatMessage) {
  // Creates the updated card that displays "You" for the assignee
  // and that disables the button.
  //
  // A hard-coded card is used in this example. In a real-life scenario,
  // an actual assign action would be performed before building the card.
  Message message = new Message().setCardsV2(List.of(new CardWithId()
    .setCardId("attachCard")
    .setCard(new GoogleAppsCardV1Card()
      .setHeader(new GoogleAppsCardV1CardHeader()
        .setTitle("Example Customer Service Case")
        .setSubtitle("Case basics"))
      .setSections(List.of(new GoogleAppsCardV1Section().setWidgets(List.of(
        new GoogleAppsCardV1Widget().setDecoratedText(new GoogleAppsCardV1DecoratedText()
          .setTopLabel("Case ID")
          .setText("case123")),
        // The assignee is now "You"
        new GoogleAppsCardV1Widget().setDecoratedText(new GoogleAppsCardV1DecoratedText()
          .setTopLabel("Assignee")
          .setText("You")),
        new GoogleAppsCardV1Widget().setDecoratedText(new GoogleAppsCardV1DecoratedText()
          .setTopLabel("Status")
          .setText("Open")),
        new GoogleAppsCardV1Widget().setDecoratedText(new GoogleAppsCardV1DecoratedText()
          .setTopLabel("Subject")
          .setText("It won't turn on...")),
        new GoogleAppsCardV1Widget().setButtonList(new GoogleAppsCardV1ButtonList()
          .setButtons(List.of(
            new GoogleAppsCardV1Button()
              .setText("OPEN CASE")
              .setOnClick(new GoogleAppsCardV1OnClick()
                .setOpenLink(new GoogleAppsCardV1OpenLink()
                  .setUrl("https://support.example.com/orders/case123"))),
            new GoogleAppsCardV1Button()
              .setText("RESOLVE CASE")
              .setOnClick(new GoogleAppsCardV1OnClick()
                .setOpenLink(new GoogleAppsCardV1OpenLink()
                  .setUrl("https://support.example.com/orders/case123?resolved=y"))),
            new GoogleAppsCardV1Button()
              .setText("ASSIGN TO ME")
              // The button is now disabled
              .setDisabled(true)
              .setOnClick(new GoogleAppsCardV1OnClick()
                .setAction(new GoogleAppsCardV1Action().setFunction(FUNCTION_URL)))
          ))
        )
      ))))
    )
  ));

  // Use the adequate action response type. It depends on whether the message
  // the preview link card is attached to was created by a human or a Chat app.
  if("HUMAN".equals(chatMessage.at("/sender/type").asText())) {
    return new GenericJson() {{
      put("hostAppDataAction", new GenericJson() {{
        put("chatDataAction", new GenericJson() {{
          put("updateInlinePreviewAction", message);
        }});
      }});
    }};
  } else {
    return new GenericJson() {{
      put("hostAppDataAction", new GenericJson() {{
        put("chatDataAction", new GenericJson() {{
          put("updateMessageAction", message);
        }});
      }});
    }};
  }
}

將 FUNCTION_URL 替換為處理按鈕點擊事件的 HTTP 端點。

Apps Script

apps-script/chat/preview-link/preview-link.gs

前往 GitHub 查看

/**
 * Assigns and updates the card that's attached to a message with a
 * previewed link of the pattern "support.example.com".
 *
 * @param {Object} event The event object from the Google Workspace add-on.
 * @return {Object} Action response depending on the message author.
 */
function assign(event) {
  // Creates the updated card that displays "You" for the assignee
  // and that disables the button.
  //
  // A hard-coded card is used in this example. In a real-life scenario,
  // an actual assign action would be performed before building the card.
  const message = { cardsV2: [{
    cardId: 'attachCard',
    card: {
      header: {
        title: 'Example Customer Service Case',
        subtitle: 'Case summary',
      },
      sections: [{ widgets: [
        { decoratedText: { topLabel: 'Case ID', text: 'case123'}},
        // The assignee is now "You"
        { decoratedText: { topLabel: 'Assignee', text: 'You'}},
        { decoratedText: { topLabel: 'Status', text: 'Open'}},
        { decoratedText: { topLabel: 'Subject', text: 'It won\'t turn on...' }},
        { buttonList: { buttons: [{
          text: 'OPEN CASE',
          onClick: { openLink: {
            url: 'https://support.example.com/orders/case123'
          }},
        }, {
          text: 'RESOLVE CASE',
          onClick: { openLink: {
            url: 'https://support.example.com/orders/case123?resolved=y',
          }},
        }, {
          text: 'ASSIGN TO ME',
          // The button is now disabled
          disabled: true,
          onClick: { action: { function: 'assign'}}
        }]}}
      ]}]
    }
  }]};

  // Use the adequate action response type. It depends on whether the message
  // the preview link card is attached to was created by a human or a Chat app.
  if(event.chat.buttonClickedPayload.message.sender.type === 'HUMAN') {
    return { hostAppDataAction: { chatDataAction: { updateInlinePreviewAction: message }}};
  } else {
    return { hostAppDataAction: { chatDataAction: { updateMessageAction: message }}};
  }
}

限制和注意事項

為 Chat 應用程式設定連結預覽時，請注意以下限制和考量事項：

每個 Chat 應用程式最多支援 5 個網址模式的連結預覽。
Chat 應用程式會預覽每則訊息中的一個連結。如果單一訊息中有多個可預覽的連結，系統只會預覽第一個可預覽的連結。
即時通訊應用程式只會預覽以 https:// 開頭的連結，因此會預覽 https://support.example.com/cases/，但不會預覽 support.example.com/cases/。
除非訊息包含其他會傳送至 Chat 應用程式的資訊 (例如斜線指令)，否則連結預覽功能只會將連結網址傳送至 Chat 應用程式。
如果使用者發布連結，只有在使用者與連結預覽資訊卡互動 (例如點選按鈕) 時，Chat 應用程式才能更新該資訊卡。您無法在 Message 資源上呼叫 Chat API 的 update() 方法，以非同步方式更新使用者的訊息。
聊天室應用程式必須為聊天室中的所有使用者預覽連結，因此訊息必須省略 privateMessageViewer 欄位。

偵錯連結預覽

導入連結預覽功能時，您可能需要讀取應用程式記錄，才能對 Chat 應用程式進行偵錯。如要讀取記錄，請前往 Google Cloud 控制台的「記錄檔探索工具」。

預覽 Google Chat 訊息中的連結 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

連結預覽功能的運作方式

必要條件

HTTP

Apps Script

設定連結預覽

預覽連結

JSON

以簡訊回覆

Node.js

Python

Java

Apps Script

附加可預覽連結的資訊卡

Node.js

Python

Java

Apps Script

更新連結預覽資訊卡

Node.js

Python

Java

Apps Script

限制和注意事項

偵錯連結預覽

預覽 Google Chat 訊息中的連結