Получение настроек уведомлений в пространстве пользователя

В этом руководстве объясняется, как использовать метод get() ресурса SpaceNotificationSetting API Google Chat для получения настроек уведомлений пользователя о местоположении.

Ресурс SpaceNotificationSetting — это ресурс-одиночка, представляющий подробную информацию о настройках уведомлений в космосе указанного пользователя.

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

Node.js

• Корпоративный аккаунт Google Workspace с доступом к Google Chat .

• Настройте свою среду:
  • Создайте проект в Google Cloud .
  • Настройте экран согласия OAuth .
  • Включите и настройте API Google Chat, указав имя, значок и описание для вашего приложения чата.
  • Установите библиотеку Node.js Cloud Client .
  • Создайте учетные данные клиента OAuth для настольного приложения. Чтобы запустить пример из этого руководства, сохраните учетные данные в виде JSON-файла с именем credentials.json в локальной директории.
  Для получения инструкций выполните шаги по настройке среды, описанные в этом кратком руководстве .
• Выберите область авторизации , которая поддерживает аутентификацию пользователей.

Примеры кода на этой странице используют интерфейс gRPC API с клиентскими библиотеками Google Cloud. В качестве альтернативы можно использовать интерфейс REST API. Дополнительную информацию об интерфейсах gRPC и REST см. в разделе «Обзор Google Chat API» .

Получите настройки уведомлений в пространстве вызывающего пользователя.

Чтобы получить подробную информацию о настройках уведомлений пользователя в рабочем пространстве, включите в свой запрос следующее:

• Укажите область авторизации chat.users.spacesettings .
• Вызовите метод GetSpaceNotificationSetting() , передав в качестве параметра name настроек уведомлений для пространства, которое включает идентификатор пользователя или псевдоним и идентификатор пространства. Вы можете получить настройки уведомлений только для вызывающего пользователя. Чтобы указать настройки, используйте один из следующих способов:
  • Псевдоним me . Например, users/me/spaces/ SPACE_ID /spaceNotificationSetting .
  • Адрес электронной почты пользователя Google Workspace, вызывающего сообщение. Например, users/[e-mail]/spaces/ SPACE_ID /spaceNotificationSetting .
  • Идентификатор пользователя, вызывающего уведомление. Например, users/ USER /spaces/ SPACE /spaceNotificationSetting .

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

Node.js

chat/client-libraries/cloud/get-space-notification-setting-user-cred.js

Посмотреть на GitHub

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

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

// This sample shows how to get the space notification setting for the calling
// user
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(
    USER_AUTH_OAUTH_SCOPES,
  );

  // Initialize request argument(s), replace the SPACE_NAME with an actual space
  // name.
  const request = {
    name: 'users/me/spaces/SPACE_NAME/spaceNotificationSetting',
  };

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

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

await main();

Для запуска этого примера замените SPACE_ID на идентификатор из name пространства. Вы можете получить идентификатор, вызвав метод ListSpaces() или из URL-адреса пространства.

API Google Chat получает указанные настройки уведомлений о наличии свободного места и возвращает экземпляр объекта SpaceNotificationSetting .

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

• Обновите настройки уведомлений о местоположении вызывающего пользователя .