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 wiadomości bezpośrednich.

SpaceZasób 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 na czacie 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 czatowania.
• Pokoje z nazwami 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 Google Chat dla całej organizacji Google Workspace, Google Chat utworzy wiadomość bezpośrednią między zainstalowaną aplikacją do Google Chat a każdym użytkownikiem w organizacji.

Uwierzytelnianie za pomocą uwierzytelniania aplikacji umożliwia aplikacji Chat uzyskiwanie dostępu do rozmów na czacie, do których ma dostęp w Google Chat (np. rozmów, w których uczestniczy). Uwierzytelnianie za pomocą uwierzytelniania użytkownika zwraca wiadomości DM, do których uwierzytelniony użytkownik ma dostęp.

Wymagania wstępne

Znajdowanie czatu

Aby znaleźć wiadomość na czacie w Google Chat, w żądaniu przekaż następujące 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 metodę FindDirectMessage(), przekazując name innego użytkownika w wiadomości DM, aby zwrócić odpowiedź. W przypadku uwierzytelniania użytkownika ta metoda zwraca wiadomość DM 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 uczestnika pokoju, podaj users/{user}, gdzie {user} to {person_id} dla person z interfejsu People API lub identyfikator user z interfejsu Directory API. Jeśli na przykład osoba w interfejsie People API resourceName to people/123456789, możesz dodać użytkownika do pokoju, uwzględniając członkostwo z users/123456789 jako member.name.

Znajdowanie wiadomości na czacie z uwierzytelnianiem użytkownika

Aby znaleźć czat z uwierzytelnianiem 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);
}

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 określonej wiadomości bezpośredniej.

Znajdowanie czatu z uwierzytelnioną aplikacją

Aby znaleźć czat z uwierzytelnianiem 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);
}

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 określonej wiadomości bezpośredniej.

Powiązane artykuły

• Utwórz pokój.
• Skonfiguruj pokój
• Sprawdzanie szczegółów pokoju
• Wyświetlanie pokoi
• Aktualizowanie pokoju
• Usuń pokój.