Uzyskiwanie szczegółów o wydarzeniu w pokoju Google Chat

Z tego przewodnika dowiesz się, jak za pomocą metody get() w zasobach SpaceEvent interfejsu Google Chat API uzyskać szczegółowe informacje o zdarzeniu z pokoju Google Chat.

Zasób SpaceEvent reprezentuje zmianę w pokoju lub jego zasobach podrzędnych, takich jak wiadomości, reakcje i członkostwo. Informacje o obsługiwanych typach zdarzeń znajdziesz w polu eventType w dokumentacji referencyjnej zasobu SpaceEvent.

Możesz poprosić o wydarzenia do 28 dni przed datą wysłania prośby. Zdarzenie zawiera najnowszą wersję zmienionego zasobu. Jeśli na przykład żądasz zdarzenia dotyczącego nowej wiadomości, ale wiadomość została później zaktualizowana, serwer zwróci zaktualizowany zasób Message w ładunku zdarzenia.

Aby wywołać tę metodę, musisz użyć uwierzytelniania użytkownika. Aby uzyskać dane o zdarzeniu, uwierzytelniony użytkownik musi być członkiem pokoju, w którym miało ono miejsce.

Wymagania wstępne

Node.js

Uzyskiwanie szczegółowych informacji o zdarzeniu w pokoju

Aby uzyskać szczegółowe informacje o zdarzeniu w pokoju w Google Chat, w żądaniu podaj:

  • Określ zakres autoryzacji, który obsługuje typ zdarzenia w żądaniu. Zalecamy wybranie najbardziej restrykcyjnego zakresu, który nadal pozwoli aplikacji na działanie.
  • Wywołaj metodę GetSpaceEvent(), przekazując name zdarzenia w pokoju.

W tym przykładzie rejestrujemy wydarzenie dotyczące pokoju:

Node.js

chat/client-libraries/cloud/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);

Aby uruchomić ten przykład, zastąp to:

  • SCOPE_NAME: zakres autoryzacji na podstawie typu zdarzenia. Jeśli na przykład otrzymujesz zdarzenie dotyczące pokoju związane z nowym członkostwem, użyj zakresu chat.memberships.readonly w formacie https://www.googleapis.com/auth/chat.memberships.readonly. Typ zdarzenia możesz pobrać z metody ListSpaceEvents(). Aby dowiedzieć się, jak korzystać z tej metody, przeczytaj artykuł Wyświetlanie zdarzeń z pokoju.
  • SPACE_NAME: identyfikator pokojuname. Identyfikator możesz uzyskać, wywołując metodę ListSpaces() lub z adresu URL pokoju.
  • SPACE_EVENT_NAME: identyfikator z name wydarzenia w pokoju. Identyfikator możesz uzyskać z metody ListSpaceEvents(). Aby dowiedzieć się, jak korzystać z tej metody, przeczytaj artykuł Wyświetlanie zdarzeń z pokoju.

Interfejs Chat API zwraca instancję SpaceEvent ze szczegółami zdarzenia.