Trovare uno spazio per i messaggi diretti

Questa guida spiega come utilizzare il metodo findDirectMessage() nella risorsa Space dell'API Google Chat per ottenere dettagli su uno spazio di messaggistica diretta (DM).

La risorsa Space rappresenta un luogo in cui persone e app di chat possono inviare messaggi, condividere file e collaborare. Esistono diversi tipi di spazi:

• I messaggi diretti sono conversazioni tra due utenti o tra un utente e un'app di chat.
• Le chat di gruppo sono conversazioni tra tre o più utenti e app di chat.
• Gli spazi denominati sono luoghi permanenti in cui le persone inviano messaggi, condividono file e collaborano.

Quando un amministratore di Google Workspace installa un'app di Chat per l'intera organizzazione Google Workspace, Google Chat crea un messaggio diretto tra l'app di Chat installata e ogni utente dell'organizzazione.

L'autenticazione con autenticazione app consente a un'app Chat di ricevere i messaggi diretti a cui l'app Chat ha accesso in Google Chat (ad esempio, i messaggi diretti di cui fa parte). L'autenticazione con l'autenticazione utente restituisce i messaggi diretti a cui l'utente autenticato ha accesso.

Prerequisiti

Trovare un messaggio diretto

Per trovare un messaggio diretto in Google Chat, trasmetti quanto segue nella richiesta:

• Con l'autenticazione dell'app, specifica l'ambito di autorizzazione chat.bot. Con l'autenticazione utente, specifica l'ambito di autorizzazione chat.spaces.readonly o chat.spaces.
• Chiama il metodo FindDirectMessage(), passando l'name dell'altro utente nel messaggio diretto da restituire. Con l'autenticazione utente, questo metodo restituisce un messaggio diretto tra l'utente chiamante e l'utente specificato. Con l'autenticazione dell'app, questo metodo restituisce un messaggio diretto tra l'app chiamante e l'utente specificato.
• Per aggiungere un utente umano come membro di uno spazio, specifica users/{user}, dove {user} è {person_id} per person dell'API People o l'ID di un user nell'API Directory. Ad esempio, se la persona dell'API People resourceName è people/123456789, puoi aggiungere l'utente allo spazio includendo un'iscrizione con users/123456789 come member.name.

Trovare un messaggio diretto con l'autenticazione utente

Ecco come trovare un messaggio diretto con autenticazione utente:

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

Per eseguire questo esempio, sostituisci USER_NAME con l'ID del campo name dell'utente.

L'API Chat restituisce un'istanza di Space che descrive in dettaglio il messaggio diretto specificato.

Trovare un messaggio diretto con l'autenticazione dell'app

Ecco come trovare un messaggio diretto con autenticazione dell'app:

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

Per eseguire questo esempio, sostituisci USER_NAME con l'ID del campo name dell'utente.

L'API Chat restituisce un'istanza di Space che descrive in dettaglio il messaggio diretto specificato.

Argomenti correlati

• Crea uno spazio.
• Configurare uno spazio.
• Visualizzare i dettagli di uno spazio.
• Elenca spazi.
• Aggiorna uno spazio.
• Eliminare uno spazio.