Method: spaces.findDirectMessage

Restituisce il messaggio diretto esistente con l'utente specificato. Se non viene trovato uno spazio per i messaggi diretti, viene restituito un errore 404 NOT_FOUND. Per un esempio, consulta Trovare un messaggio diretto.

Con l'autenticazione dell'app, restituisce lo spazio dei messaggi diretti tra l'utente specificato e l'app Chat chiamante.

Con l'autenticazione utente, restituisce lo spazio dei messaggi diretti tra l'utente specificato e l'utente autenticato.

Supporta i seguenti tipi di autenticazione:

  • Autenticazione app con l'ambito di autorizzazione:

    • https://www.googleapis.com/auth/chat.bot

  • Autenticazione utente con uno dei seguenti ambiti di autorizzazione:

    • https://www.googleapis.com/auth/chat.spaces.readonly
    • https://www.googleapis.com/auth/chat.spaces

Richiesta HTTP

GET https://chat.googleapis.com/v1/spaces:findDirectMessage

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di query

Parametri
name

string

Obbligatorio. Nome della risorsa dell'utente per trovare il messaggio diretto.

Formato: users/{user}, dove {user} è il id per la persona dell'API People o il id per l'utente nell'API Directory. Ad esempio, se l'ID profilo dell'API People è 123456789, puoi trovare un messaggio diretto con la persona utilizzando users/123456789 come name. Quando esegui l'autenticazione come utente, puoi utilizzare l'email come alias per {user}. Ad esempio, users/example@gmail.com, dove example@gmail.com è l'indirizzo email dell'utente di Google Chat.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Space.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.bot

Per ulteriori informazioni, consulta la Guida all'autorizzazione.