Znajdowanie pokoju czatu

Z tego przewodnika dowiesz się, jak użyć metody findDirectMessage() w zasobie Space interfejsu Google Chat API, aby uzyskać szczegółowe informacje o pokoju wiadomości bezpośrednich (DM).

SpaceZasób to miejsce, w którym użytkownicy i aplikacje czatu mogą wysyłać wiadomości, udostępniać pliki i współpracować. Istnieje kilka typów pokoi:

  • Czaty to rozmowy między dwoma użytkownikami lub użytkownikiem a aplikacją czatu.
  • Czaty grupowe to rozmowy między 3 lub większą liczbą użytkowników i aplikacji Google Chat.
  • Nazwane pokoje to trwałe miejsca, w których użytkownicy wysyłają wiadomości, udostępniają pliki i współpracują.

Uwierzytelnianie się za pomocą uwierzytelniania aplikacji pozwala aplikacji Google Chat uzyskiwać dostęp do rozmów na czacie, do których ma dostęp w Google Chat (np. rozmów na czacie, do których należy). Uwierzytelnianie za pomocą uwierzytelniania użytkownika zwraca wiadomości DM, do których uwierzytelniony użytkownik ma dostęp.

Wymagania wstępne

Node.js

Znajdowanie czatu

Aby znaleźć wiadomość na czacie w Google Chat, w żądaniu podaj:

  • W przypadku uwierzytelniania aplikacji określ zakres autoryzacji chat.bot. W przypadku uwierzytelniania użytkownika określ zakres autoryzacji chat.spaces.readonly lub chat.spaces.
  • Wywołaj metodę FindDirectMessage(), przekazując name innego użytkownika w DM, aby zwrócić wartość. W przypadku uwierzytelniania użytkownika ta metoda zwraca czat między użytkownikiem wywołującym a określonym użytkownikiem. W przypadku uwierzytelniania aplikacji ta metoda zwraca DM między aplikacją wywołującą a określonym użytkownikiem.
  • Aby dodać użytkownika jako uczestnika pokoju, określ wartość parametru users/{user}, gdzie {user} to albo {person_id} dla person z interfejsu People API, albo identyfikator user w interfejsie Directory API. Jeśli na przykład osoba w interfejsie People API resourceName to people/123456789, możesz dodać użytkownika do pokoju, dodając członkostwo z atrybutem users/123456789 jako member.name.

Znajdowanie wiadomości na czacie z uwierzytelnianiem użytkownika

Aby znaleźć wiadomość bezpośrednią za pomocą uwierzytelniania użytkownika:

Node.js

chat/client-libraries/cloud/find-dm-space-user-cred.js
import {createClientWithUserCredentials} from './authentication-utils.js';

const USER_AUTH_OAUTH_SCOPES = ['https://www.googleapis.com/auth/chat.spaces.readonly'];

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

  // Initialize request argument(s)
  const request = {
    // Replace USER_NAME here
    name: 'users/USER_NAME'
  };

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

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

main().catch(console.error);

Aby uruchomić ten przykład, zastąp USER_NAME identyfikatorem z pola name użytkownika.

Interfejs Chat API zwraca instancję Space, która zawiera szczegóły określonego czatu.

Znajdowanie czatu z uwierzytelnieniem aplikacji

Aby znaleźć wiadomość bezpośrednią za pomocą uwierzytelniania w aplikacji:

Node.js

chat/client-libraries/cloud/find-dm-space-app-cred.js
import {createClientWithAppCredentials} from './authentication-utils.js';

// This sample shows how to find a Direct Message space with app credential
async function main() {
  // Create a client
  const chatClient = createClientWithAppCredentials();

  // Initialize request argument(s)
  const request = {
    // Replace USER_NAME here
    name: 'users/USER_NAME'
  };

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

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

main().catch(console.error);

Aby uruchomić ten przykład, zastąp USER_NAME identyfikatorem z pola name użytkownika.

Interfejs Chat API zwraca instancję Space, która zawiera szczegółowe informacje o wybranym czacie.