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 Kaynağı, 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 almasına olanak tanır (örneğin, üyesi olduğu DM'ler). 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

Doğrudan mesaj 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_id} person veya Directory API'deki user kimliğidir. Örneğin, People API'deki kişi resourceName, people/123456789 ise member.name olarak users/123456789 ile ü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:

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ı içeren doğrudan mesajları bulma

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

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.

İlgili konular

• Alan oluşturun.
• Alan oluşturma
• Bir alan hakkında ayrıntılı bilgi edinme
• Alanları listeleme.
• Alan güncelleme
• Alan silme