Method: spaces.findDirectMessage

Gibt die vorhandene Direktnachricht an den angegebenen Nutzer zurück Wenn kein Gruppenbereich für Direktnachrichten gefunden wird, wird der Fehler 404 NOT_FOUND zurückgegeben. Ein Beispiel finden Sie unter Direktnachricht suchen.

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

Bei der App-Authentifizierung wird der Bereich für Direktnachrichten zwischen dem angegebenen Nutzer und der aufrufenden Chat-App zurückgegeben.

Erfordert eine Nutzerauthentifizierung oder eine App-Authentifizierung.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameters
name

string

Erforderlich. Ressourcenname des Nutzers, mit dem die Direktnachricht gesucht werden soll.

Format: users/{user}, wobei {user} entweder der id für die Person aus der People API oder der id für den Nutzer in der Directory API ist. Lautet die People API-Profil-ID beispielsweise 123456789, können Sie users/123456789 als name verwenden, um eine Direktnachricht an diese Person zu suchen. 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.