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

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

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

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

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

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

Предпосылки

Найти прямое сообщение

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

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

Найти прямое сообщение с аутентификацией пользователя

Вот как найти прямое сообщение с аутентификацией пользователя :

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 , в котором содержится подробная информация об указанном DM.

Найдите прямое сообщение с аутентификацией в приложении

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

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 , в котором содержится подробная информация об указанном DM.

Похожие темы

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