Найдите место для прямого сообщения (DM)

В этом руководстве объясняется, как использовать метод findDirectMessage() ресурса Space API Google Chat для получения подробной информации о пространстве для личных сообщений (DM).

Ресурс Space представляет собой место, где люди и приложения для чата могут отправлять сообщения, обмениваться файлами и сотрудничать. Существует несколько типов пространств:

• Личные сообщения (DM) — это переписка между двумя пользователями или между пользователем и приложением для чата.
• Групповые чаты — это беседы между тремя или более пользователями в чат-приложениях.
• Именованные пространства — это постоянно доступные места, где люди отправляют сообщения, обмениваются файлами и сотрудничают.

Когда администратор Google Workspace устанавливает приложение чата для всей своей организации Google Workspace , Google Chat создает личное сообщение между установленным приложением чата и каждым пользователем в организации.

Аутентификация с помощью аутентификации приложения позволяет приложению чата получать личные сообщения, к которым приложение чата имеет доступ в Google Chat (например, личные сообщения, в которых оно участвует). Аутентификация с помощью аутентификации пользователя возвращает личные сообщения, к которым имеет доступ авторизованный пользователь.

Предварительные требования

Найти личное сообщение

Чтобы найти личное сообщение в Google Chat, передайте в запросе следующее:

• При аутентификации приложения укажите область авторизации chat.bot . При аутентификации пользователя укажите область авторизации chat.spaces.readonly или chat.spaces .
• Вызовите метод FindDirectMessage() , передав name другого пользователя в личном сообщении для возврата. При аутентификации пользователя этот метод возвращает личное сообщение между вызывающим пользователем и указанным пользователем. При аутентификации приложения этот метод возвращает личное сообщение между вызывающим приложением и указанным пользователем.
• Чтобы добавить пользователя в качестве участника пространства, укажите users/{user} , где {user} — это либо {person_id} person из People API, либо ID user в Directory API. Например, если resourceName пользователя в People API — people/123456789 , вы можете добавить пользователя в пространство, указав в качестве member.name users/123456789 .

Найдите личное сообщение с подтверждением пользователя.

Вот как найти личное сообщение с подтверждением пользователя :

import {createClientWithUserCredentials} from './authentication-utils.js';

const USER_AUTH_OAUTH_SCOPES = [
  'https://www.googleapis.com/auth/chat.spaces.readonly',
];

// This sample shows how to find a Direct Message space with user credential
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(
    USER_AUTH_OAUTH_SCOPES,
  );

  // Initialize request argument(s)
  const request = {
    // Replace USER_NAME here
    name: 'users/USER_NAME',
  };

  // Make the request
  const response = await chatClient.findDirectMessage(request);

  // Handle the response
  console.log(response);
}

await main();

Для запуска этого примера замените USER_NAME на идентификатор из поля name пользователя.

API чата возвращает экземпляр объекта Space , содержащий подробную информацию об указанном личном сообщении.

Найти личное сообщение с авторизацией через приложение.

Вот как найти личное сообщение с аутентификацией в приложении :

import {createClientWithAppCredentials} from './authentication-utils.js';

// This sample shows how to find a Direct Message space with app credential
async function main() {
  // Create a client
  const chatClient = createClientWithAppCredentials();

  // Initialize request argument(s)
  const request = {
    // Replace USER_NAME here
    name: 'users/USER_NAME',
  };

  // Make the request
  const response = await chatClient.findDirectMessage(request);

  // Handle the response
  console.log(response);
}

await main();

Для запуска этого примера замените USER_NAME на идентификатор из поля name пользователя.

API чата возвращает экземпляр объекта Space , содержащий подробную информацию об указанном личном сообщении.

Связанные темы

• Создайте пространство .
• Оборудуйте рабочее место .
• Получите подробную информацию о помещении .
• Пространства списка .
• Обновить пробел .
• Удалите пробел .