Method: spaces.findDirectMessage

Gibt die vorhandene Direktnachricht mit dem angegebenen Nutzer zurück. Wenn kein Gruppenbereich für Direktnachrichten gefunden wird, wird der Fehler 404 NOT_FOUND zurückgegeben. Weitere Informationen

Bei der Nutzerauthentifizierung wird der Direktnachrichtsbereich zwischen dem angegebenen Nutzer und dem authentifizierten Nutzer zurückgegeben.

Bei der Dienstkontoauthentifizierung wird der Direktnachrichtsbereich zwischen dem angegebenen Nutzer und der aufrufenden Chat-App zurückgegeben.

Erfordert Nutzerauthentifizierung oder Dienstkontoauthentifizierung.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameter
name

string

Erforderlich. Ressourcenname des Nutzers, mit dem Direktnachrichten gefunden werden sollen.

Format: users/{user}, wobei {user} entweder die {person_id} für die Person aus der People API oder die id für den Nutzer in der Directory API ist. Wenn die Person.resourceName der People API beispielsweise people/123456789 ist, können Sie eine Direktnachricht an diese Person suchen, indem Sie users/123456789 als name verwenden. Wenn Sie als Nutzer authentifiziert sind, können Sie die E-Mail-Adresse als Alias für {user} verwenden. Beispiel: users/example@gmail.com, wobei example@gmail.com die E-Mail-Adresse des Google Chat-Nutzers ist.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Space.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.