設定 Google Chat API

您建立的每個 Google Chat 應用程式都需要專屬的 Google Cloud 專案,並啟用及設定 Chat API。本頁面說明如何設定 Chat API。

必要條件

選擇 Chat 應用程式的顯示名稱、顯示圖片和說明

啟用 Chat API 後,您可以設定 Chat 應用程式的詳細資料,包括顯示名稱、顯示圖片和說明,這些資訊會顯示在 Chat 中。這些詳細資料只會顯示在 Chat 中。如要將 Chat 擴充應用程式發布至 Marketplace,您也必須指定 Chat 擴充應用程式Marketplace 資訊中顯示的詳細資料。

如要呼叫 Chat API,您必須設定 Google Chat 應用程式,並提供下列資訊:

欄位 說明 格式
應用程式名稱 Chat 應用程式的顯示名稱。 最多 25 個半形英數字元
顯示圖片網址 顯示為 Chat 應用程式顯示圖片的圖片。 指向正方形圖片 (PNG 或 JPEG) 的 HTTPS 網址。 建議大小為 256 x 256 像素以上。
說明 簡要說明 Chat 應用程式的用途。 最多 40 個半形英數字元

Chat 應用程式的名稱、顯示圖片和說明會顯示在 Chat 使用者介面中。對於部分 Chat API 寫入要求,Chat 會使用這項資訊,將 Chat 應用程式在 Chat 中執行的動作歸因於該應用程式。

舉例來說,如果您呼叫 spaces.create() 方法,Chat 會在聊天室建立者的說明中加入 Chat 應用程式的名稱,如下圖所示:

Google Chat 應用程式為使用者建立聊天室。
圖 1. 使用 spaces.create() 方法代表使用者建立聊天室時,Chat 顯示的出處訊息。

如要與 Chat 擴充應用程式互動,使用者也可以透過下列方式查看或使用這項資訊:

  • 使用 @提及 Chat 應用程式名稱,即可叫用該應用程式。
  • 找出並開始與 Chat 應用程式互傳即時訊息。 在「應用程式」選單中,即時訊息會顯示 Chat 應用程式的名稱和顯示圖片。
  • 使用者可以在撰寫列中瀏覽 Chat 應用程式,並查看名稱、顯示圖片和說明。

在 Google Cloud 控制台中設定 Chat 應用程式

取得 Chat 應用程式詳細資料後,開啟 Cloud 專案並設定 Chat API:

  1. 在 Google Cloud 控制台中,前往 Chat API 頁面,然後按一下「Configuration」(設定) 頁面:

    前往 Chat API 設定頁面

  2. 在「應用程式資訊」下方,填寫「應用程式名稱」、「顯示圖片網址」和「說明」欄位。

  3. 在「互動功能」下方,按一下「啟用互動功能」切換鈕,將其設為關閉位置,即可停用 Chat 應用程式的互動功能。您之後可以再設定。如要瞭解如何設定及建構互動式功能,請參閱「接收及回應使用者互動」。

  4. 選用:在「記錄」下方,選取「將錯誤記錄到 Cloud Logging」核取方塊,即可使用 Google Cloud Logging。詳情請參閱「查詢 Chat 擴充應用程式的錯誤記錄」。

  5. 按一下 [儲存]

授予他人設定 Chat API 的權限

您可以授予 Chat 應用程式擁有者Chat 應用程式檢視者 Google Cloud Identity Access Management (IAM) 角色將 Chat 應用程式設定頁面的存取權授予特定使用者。具備這類角色的使用者無法透過「API 和服務」資訊主頁前往 Chat 應用程式設定頁面,但可以前往 Chat 應用程式主機 Cloud 專案的 Google Cloud 控制台,存取設定頁面,方法如下:

https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=PROJECT_ID

其中 PROJECT_ID 是代管 Chat 應用程式的 Google Cloud 專案 ID。