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.

SpaceEvent zasób reprezentuje zmianę pokoju lub jego zasobów podrzędnych, takich jak wiadomości, reakcje i członkostwa. Więcej informacji o obsługiwanych typach zdarzeń znajdziesz w Pole eventType zasobu SpaceEvent dokumentacji referencyjnej.

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

Aby wywołać tę metodę, musisz użyć uwierzytelnianie użytkownika. Aby uzyskać wydarzenie, uwierzytelniony użytkownik musi być członkiem pokoju, w którym to zdarzenie .

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 określ zakres autoryzacji obsługujący typ zdarzenia. Najlepiej wybrać najbardziej restrykcyjny zakres, który pozwala do działania.
  • Wywołaj metodę GetSpaceEvent(), przekazując name zdarzenia w pokoju.

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 to:

  • SCOPE_NAME: zakres autoryzacji na podstawie typu zdarzenia. Jeśli na przykład bierzesz udział w wydarzeniu kosmicznym, dotyczące nowej subskrypcji, użyj zakresu chat.memberships.readonly, w formacie https://www.googleapis.com/auth/chat.memberships.readonly. Rodzaj zdarzenia znajdziesz w ListSpaceEvents() . Aby dowiedzieć się, jak korzystać z tej metody, przeczytaj artykuł Wyświetlanie zdarzeń z pokoju.
  • SPACE_NAME: identyfikator pokoju name Aby go uzyskać, wywołaj metodę ListSpaces() lub z adresu URL pokoju.
  • SPACE_EVENT_NAME: identyfikator wydarzenia w pokoju name Identyfikator możesz uzyskać w ListSpaceEvents() . Aby dowiedzieć się, jak używać tej metody, zapoznaj się z artykułem Wyświetlanie listy zdarzeń z pokoju

Interfejs Chat API zwraca instancję SpaceEvent z informacjami o zdarzeniu.