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

Z tego przewodnika dowiesz się, jak użyć metody get() zasobu SpaceEvent w interfejsie Google Chat API, aby 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ą przesłania prośby. Zdarzenie zawiera najnowszą wersję zasobu, który uległ zmianie. 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:

  • W prośbie podaj zakres autoryzacji obsługujący typ zdarzenia. Zalecamy wybranie najbardziej restrykcyjnego zakresu, który nadal pozwoli aplikacji na działanie.
  • Wywołaj metodę GetSpaceEvent(), przekazując name zdarzenia pokoju, które chcesz pobrać.

W tym przykładzie uzyskujemy zdarzenie dotyczące przestrzeni:

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:

  • SCOPE_NAME: zakres autoryzacji na podstawie typu zdarzenia. Jeśli na przykład otrzymujesz zdarzenie dotyczące pokoju dotyczące nowej subskrypcji, użyj zakresu chat.memberships.readonly sformatowanego jako https://www.googleapis.com/auth/chat.memberships.readonly. Typ zdarzenia możesz uzyskać 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 korzystając z adresu URL pokoju.
  • SPACE_EVENT_NAME: identyfikator z name wydarzenia 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 z informacjami o zdarzeniu.