# 将 Google Chat 接入 Open Flow

Source: https://openflow.run/zh-cn/integrations/googlechat/

[全部集成](https://openflow.run/zh-cn/integrations/)

查找目标对话，汇总消息或发送提供的通知。

*   [8 个工具](https://openflow.run/zh-cn/integrations/googlechat/#integration-actions)
*   OAuth 2.0
*   沟通
*   效率工具

[连接 Google Chat](https://console.openflow.run/connections/googlechat)

每月 20,000 次免费应用调用（付费服务另计）

## 可以做什么

列出已加入空间、检查成员与消息历史、识别已有私信对象，并向空间或讨论串发送文本。AI 可汇总决策，并保留发送者身份与对话引用。

### 对话记录与身份

读取已加入对话、消息历史与可用成员身份。

### 纯文本消息

向空间发送文本或回复已有讨论串。

## 所有工具

8 个工具

### List Spaces

列出经过身份验证的用户所属的 Google Chat 空间，并带有可选的筛选和分页。

`googlechat.list_spaces`

### Get Space

检索单个 Google Chat 空间的详情。

`googlechat.get_space`

### Find Direct Message

按电子邮件地址或数字用户 ID 查找当前用户与另一人的现有私信空间，不创建会话。私信空间没有 displayName，list\_spaces 无法直接说明收件人。标识符拼错但恰好对应已有私信的另一用户时，仍可能查找成功；空间 ID 本身无法确认身份。结果中的 peer 表示实际参与者，发送前应向用户核对姓名，该检查不会自动强制执行。解析姓名还需要 chat.memberships.readonly、directory.readonly 权限和 People API。成员列表或自身 People ID 查询失败时，仍返回空间，peer 为 null，peerError 说明原因。AMBIGUOUS、Chat 未提供姓名的 BOT 或 SELF，以及目录无法解析姓名的 HUMAN，其 displayName 为 null；HUMAN 的 profileUnavailableReason 会说明原因。peer 或 displayName 为 null 时，收件人身份尚未确认。

`googlechat.find_direct_message`

### Get Direct Message Peer

解析私信空间的另一参与者姓名。用户鉴权下 Google Chat 可能只返回 users/{id}，缺少的姓名或电子邮件地址通过 People API 从 Workspace 目录查询。可用来识别 list\_spaces 返回的私信对方；非私信空间会被拒绝。无法解析姓名的 HUMAN 仍返回 users/{id} 和 profileUnavailableReason；BOT、SELF 只保留 Chat 提供的资料；AMBIGUOUS 的 user 为 null，并列出候选成员。

`googlechat.get_direct_message_peer`

### List Space Members

分页列出 Google Chat 空间成员及姓名、电子邮件地址，支持群组空间。与 Chat 默认行为一致，不含通过 Google Group 加入的成员及尚未接受邀请的人。用户鉴权下 Chat 可能只返回 users/{id}；当前页缺少姓名或邮件地址的人员会通过一次 People API 批量查询 Workspace 目录。将 nextPageToken 作为 pageToken 获取下一页。无法读取资料的成员保留 users/{id}，displayName 为 null，并返回 profileUnavailableReason。

`googlechat.list_space_members`

### List Messages

列出 Google Chat 空间的消息历史记录，并带有可选的筛选、排序和分页。

`googlechat.list_messages`

### Get Message

按其资源名称或按空间和消息 ID 检索单个 Google Chat 消息。

`googlechat.get_message`

### Create Message

向 Google Chat 空间发送纯文本消息，也可回复现有线程。用户鉴权仅支持纯文本，不支持卡片或附件。指定 thread 但省略 messageReplyOption 时使用 REPLY\_MESSAGE\_OR\_FAIL，避免 Google 默认行为忽略线程并新建会话。messageReplyOption 仅适用于 spaceType=SPACE 的命名空间。复用 requestId 会返回已创建的消息，不会重复发送。

`googlechat.create_message`

没有符合搜索条件的工具。

## 将 Google Chat 接入 Open Flow

[连接 Google Chat](https://console.openflow.run/connections/googlechat)

每月 20,000 次免费应用调用（付费服务另计）
