Menemukan ruang pesan langsung (DM)

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

Resource Space merepresentasikan tempat di mana orang dan aplikasi Chat dapat 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 yang persisten tempat orang mengirim pesan, berbagi file, dan berkolaborasi.

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

Mengautentikasi dengan autentikasi aplikasi memungkinkan aplikasi Chat mendapatkan DM yang dapat diakses aplikasi Chat di Google Chat (misalnya, DM yang diikuti aplikasi Chat). Mengautentikasi dengan autentikasi pengguna akan menampilkan DM yang dapat diakses oleh pengguna yang diautentikasi.

Prasyarat

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(), dengan meneruskan name pengguna lain di DM untuk ditampilkan. Dengan autentikasi pengguna, metode ini menampilkan DM antara pengguna yang memanggil dan pengguna yang ditentukan. Dengan autentikasi aplikasi, metode ini menampilkan DM antara aplikasi yang memanggil 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 resourceName People API 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:

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:

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.

Topik terkait

• Buat ruang.
• Menyiapkan ruang.
• Mendapatkan detail tentang ruang.
• Mencantumkan ruang.
• Memperbarui ruang.
• Menghapus ruang.