Gruppenbereich für Direktnachrichten (DN) suchen

In diesem Leitfaden wird beschrieben, wie Sie mit der Methode findDirectMessage() die Space-Ressource der Google Chat API verwenden, um Details zu einem Gruppenbereich für Direktnachrichten abzurufen.

Die Ressource Space ist ein Ort, an dem Nutzer und Chat-Apps Nachrichten senden, Dateien teilen und zusammenarbeiten können. Es gibt verschiedene Arten von Gruppenbereichen:

  • Direktnachrichten (DMs) sind Unterhaltungen zwischen zwei Nutzern oder einem Nutzer und einer Chat-App.
  • Gruppenchats sind Unterhaltungen zwischen drei oder mehr Nutzern und Chat-Apps.
  • Namensgruppenbereiche sind persistente Gruppenbereiche, in denen Nutzer Nachrichten senden, Dateien teilen und zusammenarbeiten können.

Wenn ein Google Workspace-Administrator eine Chat-App für seine gesamte Google Workspace-Organisation installiert, wird in Google Chat eine Direktnachricht zwischen der installierten Chat-App und jedem Nutzer in der Organisation erstellt.

Wenn Sie sich mit der App-Authentifizierung authentifizieren, kann eine Chat-App Direktnachrichten abrufen, auf die sie in Google Chat Zugriff hat, z. B. Direktnachrichten, in denen sie Mitglied ist. Bei der Authentifizierung mit der Nutzerauthentifizierung werden Direktnachrichten zurückgegeben, auf die der authentifizierte Nutzer Zugriff hat.

Vorbereitung

Node.js

Direktnachrichten suchen

Wenn Sie eine Direktnachricht in Google Chat finden möchten, geben Sie Folgendes in Ihrer Anfrage an:

  • Geben Sie bei der App-Authentifizierung den Autorisierungsbereich chat.bot an. Geben Sie bei der Nutzerauthentifizierung den Autorisierungsbereich chat.spaces.readonly oder chat.spaces an.
  • Rufe die Methode FindDirectMessage() auf und übergebe den name des anderen Nutzers in der DM, der zurückgegeben werden soll. Bei der Nutzerauthentifizierung gibt diese Methode eine DM zwischen dem aufrufenden Nutzer und dem angegebenen Nutzer zurück. Bei der App-Authentifizierung gibt diese Methode eine DM zwischen der anrufenden App und dem angegebenen Nutzer zurück.
  • Wenn Sie einen Nutzer als Mitglied eines Gruppenbereichs hinzufügen möchten, geben Sie users/{user} an. Dabei ist users/{user} entweder die {person_id} für die person aus der People API oder die ID eines user in der Directory API.{user} Wenn die Person resourceName der People API beispielsweise people/123456789 ist, können Sie den Nutzer dem Gruppenbereich hinzufügen, indem Sie eine Mitgliedschaft mit users/123456789 als member.name angeben.

Direktnachricht mit Nutzerauthentifizierung suchen

So findest du eine Direktnachricht mit Nutzerauthentifizierung:

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

Ersetzen Sie zum Ausführen dieses Beispiels USER_NAME durch die ID aus dem Feld name des Nutzers.

Die Chat API gibt eine Instanz von Space zurück, die Details zur angegebenen DM enthält.

Direktnachricht mit App-Authentifizierung suchen

So finden Sie eine Direktnachricht mit App-Authentifizierung:

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

Ersetzen Sie zum Ausführen dieses Beispiels USER_NAME durch die ID aus dem Feld name des Nutzers.

Die Chat API gibt eine Instanz von Space zurück, die Details zur angegebenen DM enthält.