Doğrudan mesaj (DM) alanı bulma

Bu kılavuzda, doğrudan mesaj (DM) alanıyla ilgili ayrıntıları almak için Google Chat API'nin Space kaynağındaki findDirectMessage() metodunun nasıl kullanılacağı açıklanmaktadır.

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

  • Doğrudan mesajlar (DM'ler), iki kullanıcı veya bir kullanıcı ile Chat uygulaması arasındaki görüşmelerdir.
  • Grup sohbetleri, üç veya daha fazla kullanıcı ile Chat 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 Chat uygulaması yüklediğinde Google Chat, yüklenen Chat uygulaması ile kuruluştaki her kullanıcı arasında bir DM oluşturur.

Uygulama kimlik doğrulaması ile kimlik doğrulama, 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 yaptığınızda, kimliği doğrulanmış kullanıcının erişebildiği DM'ler döndürülü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ıyla chat.bot yetkilendirme kapsamını belirtin. Kullanıcı kimlik doğrulaması ile chat.spaces.readonly veya chat.spaces yetkilendirme kapsamını belirtin.
  • Döndürmek için DM'deki diğer kullanıcının name değerini ileterek 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.
  • Gerçek bir kullanıcıyı alan üyesi olarak eklemek için users/{user} değerini belirtin. Bu değerde {user}, People API'deki person için {person_id} veya Directory API'deki user kimliğidir. Örneğin, People API kişisi resourceName people/123456789 ise member.name olarak users/123456789 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 bir doğrudan mesajı 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);
}

main().catch(console.error);

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ıyla doğrudan mesaj bulma

Uygulama kimlik doğrulaması içeren bir 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);
}

main().catch(console.error);

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.