辨識及指定 Google Chat 使用者

本頁面說明 Google Chat 應用程式識別或指定使用者的方式 。

如要執行下列任一操作，請使用 Chat 應用程式 必須指定使用者：

• 撰寫訊息 使用@ 號提及使用者。
• 邀請或新增使用者 現有空間 或是將使用者新增至 新聊天室。
• 尋找即時訊息 與指定使用者共用即時通訊應用程式 這種做法
• 取得使用者的聊天室詳細資料。
• 傳送私人訊息給使用者。
• 使用 透過 Google Workspace Event API，取得有關成員異動的事件。

Chat 如何識別使用者

Google Chat API 會產生 User 項資源 每位 Chat 使用者以下是兩個 User 欄位：

• name 是資源的資源名稱，格式為 users/{user}。 其中 {user} 代表不重複的固定 ID。「users/app」可以 做為 進行通話的 Chat 應用程式別名
• type 是使用者類型。這個類型可讓 Chat 瞭解 是 Chat 應用程式或使用者。適用對象 即時通訊應用程式，值為 BOT。以人來說，價值是 HUMAN。

在呼叫 Google Chat API 時指定使用者

如要指定使用者，請針對 {user} 值使用下列值：

• 如要邀請 Google Workspace 機構使用者，請使用下列其中一個 方法如下：

  • 通知的 name User 項資源 啟用此功能，例如 users/123456789。
  • 名稱的 {person_id} People API 中有 Person 項資源， resourceName 為 people/{person_id}。例如， Chat API 中的 users/123456789 代表同一人 People API 中的 people/123456789。
  • Directory API 中 User 資源的 id，例如： Chat API 中的 users/123456789 代表同一人 在 Directory API 中做為 users/123456789 使用。

• 外部 Google Workspace 機構或使用者 使用的是 Google 帳戶、電子郵件別名，例如 users/EMAIL_USERNAME@WORKSPACE_DOMAIN.com 或 users/[e-mail]。

透過互動事件識別使用者

每當使用者與 Chat 應用程式互動時， Chat 會傳送 使用者與廣告的互動情形舉例來說 使用者在訊息中提及 Chat 應用程式時， Chat 應用程式會接收互動資訊， 包括訊息內容，以及傳送者的身分Chat 擴充應用程式 擷取 Chat 資源相關資訊時參照使用者。

如要找出曾與 Chat 應用程式互動的使用者， 取得該函式上 name 屬性的值 User 項資源， 提供自如 Event.user.name。

以下 JSON 範例為 如何與 Chat 應用程式互動：

{
  ...,
  "user": {
    "name": "users/12345678901234567890",
    "displayName": "Sasha",
    "avatarUrl": "https://lh3.googleusercontent.com/.../photo.jpg",
    "email": "[e-mail]"
  }
}

訊息是指特定的互動類型。找出傳送者 傳送訊息至 Chat 應用程式 取得該函式上 name 屬性的值 User 資源，請使用 包括：

• spaces.messages.sender.name
• Event.user.name

相關主題

• 將使用者加入聊天室。
• 管理聊天室中的成員。
• 在訊息中使用@ 號提及使用者。