Znajdowanie pokoju czatu

bookmark_border Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Z tego przewodnika dowiesz się, jak użyć metody findDirectMessage() w zasobach 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ą.

Gdy administrator Google Workspace zainstaluje aplikację Google Chat dla całej organizacji Google Workspace, Google Chat utworzy DM między zainstalowaną aplikacją Google Chat a każdym użytkownikiem w organizacji.

Uwierzytelnianie za pomocą uwierzytelniania aplikacji pozwala aplikacji Google Chat uzyskiwać dostęp do czatów, do których ma dostęp w Google Chat (np. czatów, do których należy). Uwierzytelnianie za pomocą uwierzytelniania użytkownika zwraca DM-y, do których uwierzytelniony użytkownik ma dostęp.

Wymagania wstępne

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 DM między wywołującym użytkownikiem 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} użytkownika person z interfejsu People API, albo identyfikator user z interfejsu Directory API. Jeśli na przykład osoba z interfejsu People API resourceName jest people/123456789, możesz dodać użytkownika do pokoju, podając członkostwo z users/123456789 jako member.name.

Znajdowanie wiadomości na czacie z uwierzytelnianiem użytkownika

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

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ślonej rozmowy na czacie.

Znajdowanie czatu z uwierzytelnianiem aplikacji

Aby znaleźć czat indywidualny za pomocą uwierzytelniania w 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óły określonej rozmowy na czacie.

Powiązane artykuły

• Utwórz pokój.
• Skonfiguruj pokój.
• Znajdowanie informacji o pokoju
• Lista pokoi.
• Zaktualizuj pokój.
• Usuwanie pokoju.