Menemukan ruang pesan langsung (DM)

Panduan ini menjelaskan cara menggunakan metode findDirectMessage() di resource Space Google Chat API untuk mendapatkan detail tentang ruang pesan langsung (DM).

Resource Space mewakili tempat bagi orang dan aplikasi Chat untuk mengirim pesan, berbagi file, dan berkolaborasi. Ada beberapa jenis ruang:

  • Pesan langsung (DM) adalah percakapan antara dua pengguna atau pengguna dan aplikasi Chat.
  • Chat grup adalah percakapan antara tiga pengguna atau lebih dan aplikasi Chat.
  • Ruang bernama adalah tempat persisten tempat orang mengirim pesan, berbagi file, dan berkolaborasi.

Saat administrator Google Workspace menginstal aplikasi Chat untuk seluruh organisasi Google Workspace mereka, Google Chat akan membuat DM antara aplikasi Chat yang diinstal dan setiap pengguna di organisasi.

Dengan melakukan autentikasi menggunakan autentikasi aplikasi, aplikasi Chat dapat mendapatkan DM yang diakses oleh aplikasi Chat di Google Chat (misalnya, DM yang menjadi anggotanya). Mengautentikasi dengan autentikasi pengguna akan menampilkan DM yang dapat diakses oleh pengguna yang diautentikasi.

Prasyarat

Node.js

Menemukan pesan langsung

Untuk menemukan pesan langsung di Google Chat, teruskan hal berikut dalam permintaan Anda:

  • Dengan autentikasi aplikasi, tentukan cakupan otorisasi chat.bot. Dengan autentikasi pengguna, tentukan cakupan otorisasi chat.spaces.readonly atau chat.spaces.
  • Panggil metode FindDirectMessage(), yang meneruskan name pengguna lain di DM untuk ditampilkan. Dengan autentikasi pengguna, metode ini menampilkan DM antara pengguna yang melakukan panggilan dan pengguna yang ditentukan. Dengan autentikasi aplikasi, metode ini menampilkan DM antara aplikasi panggilan dan pengguna yang ditentukan.
  • Untuk menambahkan pengguna manusia sebagai anggota ruang, tentukan users/{user}, dengan {user} adalah {person_id} untuk person dari People API, atau ID user di Directory API. Misalnya, jika orang People API resourceName adalah people/123456789, Anda dapat menambahkan pengguna ke ruang dengan menyertakan keanggotaan dengan users/123456789 sebagai member.name.

Menemukan pesan langsung dengan autentikasi pengguna

Berikut cara menemukan pesan langsung dengan autentikasi pengguna:

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

Untuk menjalankan contoh ini, ganti USER_NAME dengan ID dari kolom name pengguna.

Chat API menampilkan instance Space yang menjelaskan DM yang ditentukan.

Menemukan pesan langsung dengan autentikasi aplikasi

Berikut cara menemukan pesan langsung dengan autentikasi aplikasi:

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

Untuk menjalankan contoh ini, ganti USER_NAME dengan ID dari kolom name pengguna.

Chat API menampilkan instance Space yang menjelaskan DM yang ditentukan.