此页面由 Cloud Translation API 翻译。

查找私信 (DM) 聊天室

本指南介绍了如何在 Space 上使用 findDirectMessage 方法资源，以获取私信 (DM) 聊天室的详细信息。

通过 Space 资源代表用户和 Chat 扩展应用能够发送消息的位置，共享文件和协作聊天室分为以下几种类型：

私信 (DM) 是指两位用户或一位用户与 Chat 应用。
群聊是三位或更多用户之间的对话，聊天应用。
已命名的聊天室是用户永久保留的位置，可供用户发送消息、共享文件和协作。

身份验证方式应用身份验证向聊天应用发送私信时 Chat 应用有权在 Google Chat 中访问（例如其成员的私信）。身份验证方式进行用户身份验证时，系统会返回可以访问哪些文件

前提条件

Python

Business 或 Enterprise 有权访问以下内容的 Google Workspace 账号： Google Chat。

Python 3.6 或更高版本
pip 软件包管理工具
最新的 Google 客户端库。若要安装或更新这些应用在命令行界面中运行以下命令：
```
pip3 install --upgrade google-api-python-client google-auth-oauthlib
```

设置您的环境：
- 创建 Google Cloud 项目。
- 配置 OAuth 权限请求页面。
- 启用并配置 Google Chat API，指定一个名称，图标和说明。
- 根据您希望在 Google Chat API 请求中进行身份验证的方式创建访问凭据：
  - 如需以 Chat 用户身份进行身份验证，请按以下步骤操作：创建 OAuth 客户端 ID 凭据，然后将凭据保存为名为 client_secrets.json 复制到您的本地目录。
  - 如需以 Chat 应用的身份进行身份验证，请执行以下操作：创建服务账号凭据。
选择授权范围取决于您是想以用户身份还是 Chat 应用。

Node.js

Business 或 Enterprise 有权访问以下内容的 Google Workspace 账号： Google Chat。

Node.js 14 或更高版本
npm 软件包管理工具
最新的 Google 客户端库。若要安装或更新这些应用在命令行界面中运行以下命令：
```
npm install @google-cloud/local-auth @googleapis/chat
```

设置您的环境：
- 创建 Google Cloud 项目。
- 配置 OAuth 权限请求页面。
- 启用并配置 Google Chat API，指定一个名称，图标和说明。
- 根据您希望在 Google Chat API 请求中进行身份验证的方式创建访问凭据：
  - 如需以 Chat 用户身份进行身份验证，请按以下步骤操作：创建 OAuth 客户端 ID 凭据，然后将凭据保存为名为 client_secrets.json 复制到您的本地目录。
  - 如需以 Chat 应用的身份进行身份验证，请执行以下操作：创建服务账号凭据。
选择授权范围取决于您是想以用户身份还是 Chat 应用。

查找私信

如需在 Google Chat 中查找私信，请将以下内容传入您的请求：

使用应用身份验证时，请指定 chat.bot 授权范围。包含用户身份验证，指定 chat.spaces.readonly 或 chat.spaces 授权范围。
调用 findDirectMessage 方法针对 User 资源，传递 name 其他用户所返回的内容包含用户身份验证，此方法会返回调用方用户与指定用户之间的私信。包含应用身份验证，此方法返回发起调用的应用和指定用户之间的私信。
如需将真人用户添加为聊天室成员，请指定 users/{user}，其中 {user} 是 {person_id} person 来自 People API 的 user 目录 API。例如，如果 People API 人员 resourceName 为 people/123456789，您可以通过添加 users/123456789是member.name的会员。

查找经过用户身份验证的私信

下面介绍了如何查找私信用户身份验证：

Python

在您的工作目录中，创建一个名为 chat_space_find_dm_user.py 的文件。

在 chat_space_find_dm_user.py 中添加以下代码：

from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build

# Define your app's authorization scopes.
# When modifying these scopes, delete the file token.json, if it exists.
SCOPES = ["https://www.googleapis.com/auth/chat.spaces.readonly"]

def main():
    '''
    Authenticates with Chat API via user credentials,
    then returns details about a specified DM.
    '''

    # Authenticate with Google Workspace
    # and get user authorization.
    flow = InstalledAppFlow.from_client_secrets_file(
                      'client_secrets.json', SCOPES)
    creds = flow.run_local_server()

    # Build a service endpoint for Chat API.
    chat = build('chat', 'v1', credentials=creds)

    # Use the service endpoint to call Chat API.
    result = chat.spaces().findDirectMessage(

          # The other user in the direct message (DM) to return.
          #
          # Replace USER with a user name.
          name='users/USER'

      ).execute()

    # Prints details about the direct message.
    print(result)

if __name__ == '__main__':
    main()

在代码中，将 USER 替换为 name User。
在您的工作目录中，构建并运行该示例：
```
python3 chat_space_find_dm_user.py
```

Node.js

在您的工作目录中，创建一个名为 find-direct-message-space.js。

在 find-direct-message-space.js 中添加以下代码：

const chat = require('@googleapis/chat');
const {authenticate} = require('@google-cloud/local-auth');

/**
* Find a direct message Chat space for a user.
* @return {!Promise<!Object>}
*/
async function findDirectMessageSpace() {
  const scopes = [
    'https://www.googleapis.com/auth/chat.spaces.readonly',
  ];

  const authClient =
      await authenticate({scopes, keyfilePath: 'client_secrets.json'});

  const chatClient = await chat.chat({version: 'v1', auth: authClient});

  return await chatClient.spaces.findDirectMessage(
      {name: 'users/USER'});
}

findDirectMessageSpace().then(console.log);

在代码中，将 USER 替换为 name User。
在您的工作目录中，运行该示例：
```
node find-direct-message-space.js
```

Chat API 会返回 Space 指定私信的详细信息

查找通过应用身份验证的私信

下面介绍了如何查找私信应用身份验证：

Python

在您的工作目录中，创建一个名为 chat_space_find_dm_app.py 的文件。

在 chat_space_find_dm_app.py 中添加以下代码：

from google.oauth2 import service_account
from apiclient.discovery import build

# Specify required scopes.
SCOPES = ['https://www.googleapis.com/auth/chat.bot']

# Specify service account details.
CREDENTIALS = (
    service_account.Credentials.from_service_account_file('credentials.json')
    .with_scopes(SCOPES)
)

# Build the URI and authenticate with the service account.
chat = build('chat', 'v1', credentials=CREDENTIALS)

# Use the service endpoint to call Chat API.
result = chat.spaces().findDirectMessage(

    # The other user in the direct message (DM) to return.
    #
    # Replace USER with a user name.
    name='users/USER'

).execute()

print(result)

在代码中，将 USER 替换为 name User。
在您的工作目录中，构建并运行该示例：
```
python3 chat_space_find_dm_app.py
```

Node.js

在您的工作目录中，创建一个名为 app-find-direct-message-space.js。

在 app-find-direct-message-space.js 中添加以下代码：

const chat = require('@googleapis/chat');

/**
* Find a direct message Chat space for a user.
* @return {!Promise<!Object>}
*/
async function findDirectMessageSpace() {
  const scopes = [
    'https://www.googleapis.com/auth/chat.bot',
  ];

  const auth = new chat.auth.GoogleAuth({
    scopes,
    keyFilename: 'credentials.json',
  });

  const authClient = await auth.getClient();

  const chatClient = await chat.chat({version: 'v1', auth: authClient});

  return await chatClient.spaces.findDirectMessage(
      {name: 'users/USER'});
}

findDirectMessageSpace().then(console.log);

在代码中，将 USER 替换为 name User。
在您的工作目录中，运行该示例：
```
node app-find-direct-message-space.js
```

Chat API 会返回 Space：详细说明指定私信。

查找私信 (DM) 聊天室

前提条件

Python

Node.js

查找私信

查找经过用户身份验证的私信

Python

Node.js

查找通过应用身份验证的私信

Python

Node.js

相关主题