使用 Google Chat API 傳送訊息

本指南說明如何使用 Google Chat API Message 資源的 create() 方法，執行下列任一操作：

  • 傳送含有文字、資訊卡和互動式小工具的訊息。
  • 私下傳送訊息給特定 Chat 使用者。
  • 發起或回覆訊息討論串。
  • 為訊息命名，以便在其他 Chat API 要求中指定該訊息。

訊息大小上限 (包括任何文字或資訊卡) 為 32,000 個位元組。 如要傳送超過此大小的訊息，Chat 應用程式必須改為傳送多則訊息。

除了呼叫 Chat API 建立訊息，Chat 應用程式也可以建立及傳送訊息，回覆使用者互動，例如在使用者將 Chat 應用程式新增至聊天室後，發布歡迎訊息。回覆互動時，Chat 應用程式可以使用其他類型的訊息功能，包括互動式對話方塊和連結預覽介面。如要回覆使用者，Chat 應用程式會同步傳回訊息，而不需呼叫 Chat API。如要瞭解如何傳送訊息來回覆互動，請參閱「透過 Google Chat 應用程式接收及回覆互動」。

Chat 如何顯示及歸因於使用 Chat API 建立的訊息

您可以使用應用程式驗證和使用者驗證呼叫 create() 方法。Chat 會根據您使用的驗證類型，以不同方式標示訊息傳送者。

以 Chat 應用程式的身分驗證後，Chat 應用程式就會傳送訊息。

使用應用程式驗證呼叫 create() 方法。
圖 1：透過應用程式驗證，Chat 應用程式會傳送訊息。為標示傳送者不是真人，Chat 會在名稱旁顯示 App。

以使用者身分驗證時，Chat 應用程式會代表使用者傳送訊息。即時通訊也會顯示應用程式名稱，將訊息歸因於即時通訊應用程式。

使用使用者驗證呼叫 create() 方法。
圖 2：使用者通過驗證後傳送訊息，Chat 會在使用者名稱旁顯示 Chat 應用程式名稱。

驗證類型也會決定您可以在訊息中加入哪些訊息功能和介面。透過應用程式驗證，Chat 應用程式可以傳送含有 RTF 文字、以資訊卡為基礎的介面和互動式小工具的訊息。由於 Chat 使用者只能在訊息中傳送文字，因此使用使用者驗證建立訊息時，只能加入文字。如要進一步瞭解 Chat API 提供的訊息功能，請參閱「Google Chat 訊息總覽」。

本指南說明如何使用任一驗證類型，透過 Chat API 傳送訊息。

必要條件

Node.js

Python