Doğrudan mesaj (DM) alanı bulma

Bu kılavuzda, doğrudan mesaj (DM) alanı hakkında ayrıntılı bilgi edinmek için Google Chat API'nin Space kaynağında findDirectMessage() yönteminin nasıl kullanılacağı açıklanmaktadır.

Space Kaynak, kullanıcıların ve Chat uygulamalarının mesaj gönderebileceği, dosya paylaşabileceği ve ortak çalışma yapabileceği bir yeri temsil eder. Birkaç tür alan vardır:

  • Doğrudan mesajlar (DM), iki kullanıcı veya bir kullanıcı ile bir Chat uygulaması arasındaki görüşmelerdir.
  • Grup sohbetleri, üç veya daha fazla kullanıcı ile sohbet uygulamaları arasındaki görüşmelerdir.
  • Adlandırılmış alanlar, kullanıcıların mesaj gönderdiği, dosya paylaştığı ve ortak çalıştığı kalıcı yerlerdir.

Bir Google Workspace yöneticisi Google Workspace kuruluşunun tamamı için bir Chat uygulaması yüklediğinde, Google Chat yüklenen Chat uygulaması ile kuruluştaki her kullanıcı arasında bir doğrudan mesaj oluşturur.

Uygulama kimlik doğrulaması ile kimlik doğrulama, bir Chat uygulamasının Google Chat'te erişebildiği DM'leri (ör. üyesi olduğu DM'ler) almasına olanak tanır. Kullanıcı kimlik doğrulaması ile kimlik doğrulama, kimliği doğrulanmış kullanıcının erişebildiği DM'leri döndürür.

Ön koşullar

Node.js

Doğrudan mesajları bulma

Google Chat'te doğrudan mesaj bulmak için isteğinizde aşağıdakileri iletin:

  • Uygulama kimlik doğrulaması ile chat.bot yetkilendirme kapsamını belirtin. Kullanıcı kimlik doğrulaması ile chat.spaces.readonly veya chat.spaces yetkilendirme kapsamını belirtin.
  • Döndürülecek DM'deki diğer kullanıcının name değerini ileten FindDirectMessage() yöntemini çağırın. Kullanıcı kimlik doğrulaması ile bu yöntem, arayan kullanıcı ile belirtilen kullanıcı arasında bir DM döndürür. Uygulama kimlik doğrulaması ile bu yöntem, arayan uygulama ile belirtilen kullanıcı arasında bir DM döndürür.
  • Bir kullanıcıyı alan üyesi olarak eklemek için users/{user} değerini belirtin. Burada {user}, People API'den alınan person için {person_id} veya Directory API'deki user kimliğidir. Örneğin, People API kişisi resourceName ise people/123456789, users/123456789 değerini member.name olarak içeren bir üyelik ekleyerek kullanıcıyı alana ekleyebilirsiniz.

Kullanıcı kimlik doğrulamasıyla doğrudan mesaj bulma

Kullanıcı kimlik doğrulaması içeren doğrudan mesajları bulmak için:

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

await main();

Bu örneği çalıştırmak için USER_NAME yerine kullanıcının name alanındaki kimliği girin.

Chat API, belirtilen DM'nin ayrıntılarını içeren bir Space örneği döndürür.

Uygulama kimlik doğrulaması içeren doğrudan mesajları bulma

Uygulama kimlik doğrulaması ile doğrudan mesajı bulmak için:

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

await main();

Bu örneği çalıştırmak için USER_NAME yerine kullanıcının name alanındaki kimliği girin.

Chat API, belirtilen DM'nin ayrıntılarını içeren bir Space örneği döndürür.