Znajdowanie pokoju czatu

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

Zasób Space reprezentuje miejsce, w którym użytkownicy i aplikacje do obsługi czatu mogą wysyłać wiadomości, udostępniać pliki i współpracować. Istnieje kilka rodzajów pokoi:

• Wiadomości bezpośrednie to rozmowy między 2 użytkownikami lub między użytkownikiem a aplikacją do obsługi czatu.
• Czaty grupowe to rozmowy między co najmniej 3 użytkownikami i aplikacjami do obsługi czatu.
• Pokoje nazwane to trwałe miejsca, w których użytkownicy mogą wysyłać wiadomości, udostępniać pliki i współpracować.

Gdy administrator Google Workspace zainstaluje aplikację do obsługi czatu w całej organizacji Google Workspace, Google Chat utworzy wiadomość bezpośrednią między zainstalowaną aplikacją do obsługi czatu a każdym użytkownikiem w organizacji.

Uwierzytelnianie za pomocą uwierzytelniania aplikacji umożliwia aplikacji do obsługi czatu uzyskiwanie wiadomości bezpośrednich, do których ma dostęp w Google Chat (np. wiadomości bezpośrednich, których jest członkiem). Uwierzytelnianie za pomocą uwierzytelniania użytkownika zwraca wiadomości bezpośrednie, do których ma dostęp uwierzytelniony użytkownik.

Wymagania wstępne

Znajdowanie czatu

Aby znaleźć wiadomość bezpośrednią w Google Chat, w żądaniu podaj te informacje:

• 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 FindDirectMessage(), metodę przekazując name drugiego użytkownika w wiadomości bezpośredniej, którą chcesz zwrócić. W przypadku uwierzytelniania użytkownika, ta metoda zwraca wiadomość bezpośrednią między użytkownikiem wywołującym a określonym użytkownikiem. W przypadku uwierzytelniania aplikacji ta metoda zwraca wiadomość bezpośrednią między aplikacją wywołującą a określonym użytkownikiem.
• Aby dodać użytkownika jako członka pokoju, określ users/{user}, gdzie {user}{person_id} to person w przypadku z interfejsu People API lub identyfikator user w interfejsie Directory API. Jeśli na przykład resourceName osoby w interfejsie People API to people/123456789, możesz dodać użytkownika do pokoju, dodając członkostwo z users/123456789 jako member.name.

Znajdowanie wiadomości bezpośredniej za pomocą uwierzytelniania użytkownika

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

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);
}

await main();

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

Interfejs Chat API zwraca instancję Space , która zawiera szczegółowe informacje o określonej wiadomości bezpośredniej.

Znajdowanie wiadomości bezpośredniej za pomocą uwierzytelniania aplikacji

Oto jak znaleźć wiadomość bezpośrednią za pomocą uwierzytelniania aplikacji:

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);
}

await main();

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

Interfejs Chat API zwraca instancję Space , która zawiera szczegółowe informacje o określonej wiadomości bezpośredniej.

Powiązane artykuły

• Tworzenie pokoju.
• Konfigurowanie pokoju.
• Uzyskiwanie szczegółowych informacji o pokoju.
• Wyświetlanie listy pokoi.
• Aktualizowanie pokoju.
• Usuwanie pokoju.