Получите подробную информацию о мероприятии в Google Chat

В этом руководстве объясняется, как использовать метод get() ресурса SpaceEvent API Google Chat, чтобы получить подробную информацию о событии из пространства Google Chat.

Ресурс SpaceEvent представляет собой изменение пространства или его дочерних ресурсов, таких как сообщения, реакции и членство. Чтобы узнать о поддерживаемых типах событий, см. поле eventType справочной документации по ресурсам SpaceEvent .

Вы можете запросить мероприятия за 28 дней до момента запроса. Событие содержит самую последнюю версию измененного ресурса. Например, если вы запрашиваете событие о новом сообщении, но позже оно было обновлено, сервер возвращает обновленный ресурс Message в полезных данных события.

Для вызова этого метода необходимо использовать аутентификацию пользователя . Чтобы получить событие, аутентифицированный пользователь должен быть членом пространства, в котором произошло событие.

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

Node.js

Узнайте подробности о космическом событии

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

  • Укажите область авторизации, которая поддерживает тип события в вашем запросе. Рекомендуется выбирать наиболее ограниченную область, которая по-прежнему позволяет вашему приложению функционировать.
  • Вызовите метод GetSpaceEvent() , передав name космического события, которое нужно получить.

Следующий пример получает космическое событие:

Node.js

чат/клиент-библиотеки/облако/get-space-event-user-cred.js
import {createClientWithUserCredentials} from './authentication-utils.js';

// Replace SCOPE_NAME here with an authorization scope based on the event type
const USER_AUTH_OAUTH_SCOPES = ['SCOPE_NAME'];

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

  // Initialize request argument(s)
  const request = {
    // Replace SPACE_NAME and SPACE_EVENT_NAME here
    name: 'spaces/SPACE_NAME/spaceEvents/SPACE_EVENT_NAME'
  };

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

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

main().catch(console.error);

Чтобы запустить этот пример, замените следующее:

  • SCOPE_NAME : область авторизации, основанная на типе события. Например, если вы получаете космическое событие о новом членстве, используйте область chat.memberships.readonly в формате https://www.googleapis.com/auth/chat.memberships.readonly . Тип события можно получить из метода ListSpaceEvents() . Чтобы узнать, как использовать этот метод, см. раздел Список событий из пространства .
  • SPACE_NAME : идентификатор из name пространства. Вы можете получить идентификатор, вызвав метод ListSpaces() или по URL-адресу пространства.
  • SPACE_EVENT_NAME : идентификатор из name космического события. Вы можете получить идентификатор из метода ListSpaceEvents() . Чтобы узнать, как использовать этот метод, см. раздел Список событий из пространства .

API чата возвращает экземпляр SpaceEvent с подробной информацией о событии.