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 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 Orte, an denen Nutzer Nachrichten senden, Dateien teilen und zusammenarbeiten können.

Durch die Authentifizierung mit der App-Authentifizierung kann eine Chat-App DNs erhalten, auf die die Chat-App in Google Chat Zugriff hat (z. B. DMs, in denen sie Mitglied ist). Bei der Authentifizierung mit der Nutzerauthentifizierung werden nur 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 aufrufenden 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 einer 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.

Direktnachrichten 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.

Direktnachrichten mit App-Authentifizierung suchen

So finden Sie eine Direktnachricht mit der 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.