Method: spaces.findDirectMessage

Gibt die vorhandene Direktnachricht mit dem angegebenen Nutzer zurück. Wenn kein Direktnachrichtenbereich gefunden wird, wird der Fehler 404 NOT_FOUND zurückgegeben. Ein Beispiel finden Sie unter Direktnachrichten suchen.

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

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

Unterstützt die folgenden Authentifizierungstypen:

  • App-Authentifizierung mit dem Autorisierungsbereich:

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

  • Nutzerauthentifizierung mit einem der folgenden Autorisierungsbereiche:

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

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, für den eine Direktnachricht gefunden werden soll.

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