Google Chat-Nutzer identifizieren und spezifizieren

Auf dieser Seite wird erläutert, wie Google Chat-Apps Chat-Nutzer

Zum Ausführen der folgenden Aktionen verwenden Sie eine Chat-App muss einen Nutzer angeben:

So werden Nutzer in Google Chat identifiziert

Die Google Chat API generiert ein User-Ressource für jede Person, die Google Chat verwendet. Im Folgenden sind zwei wichtige User-Felder:

  • name ist der Ressourcenname der Ressource im Format users/{user}. Dabei steht {user} für eine eindeutige und stabile ID. users/app kann als Alias für die aufrufende Chat-App.
  • type ist der Typ des Nutzers. Mit diesem Typ wird in Google Chat festgelegt, ein Nutzer eine Chat-App oder eine Person ist. Für Chat-Apps, der Wert ist BOT. Für Menschen ist der Wert HUMAN

Nutzer in einem Aufruf an die Google Chat API angeben

Verwenden Sie die folgenden Werte für den Wert {user}, um einen Nutzer anzugeben:

  • Verwenden Sie für Nutzer in Ihrer Google Workspace-Organisation eine der wie folgt vorgehen:

    • Der name des User-Ressource in der Chat API verwenden, z. B. users/123456789.
    • Die {person_id} für den Namen eines Ressource Person in der People API, Dabei ist resourceName people/{person_id}, z. B. users/123456789 in der Chat API steht für dieselbe Person als people/123456789 in der People API.
    • Die id für eine User-Ressource in der Directory API, z. B. users/123456789 in der Chat API steht für dieselbe Person als users/123456789 in der Directory API.

  • Für einen Nutzer in einer externen Google Workspace-Organisation oder einen Nutzer die ein Google-Konto nutzen, verwenden Sie einen E-Mail-Alias, z. B. users/EMAIL_USERNAME@WORKSPACE_DOMAIN.com oder users/EMAIL_USERNAME@gmail.com.

Nutzer anhand eines Interaktionsereignisses identifizieren

Jedes Mal, wenn ein Nutzer mit einer Chat-App interagiert, Chat sendet eine interaction event (Interaktionsereignis) mit Informationen zum Ereignis die Interaktion und die Nutzenden. Wenn zum Beispiel ein der Nutzer in einer Nachricht eine Chat-App erwähnt, Die Chat-App erhält Informationen über die Interaktion, unter anderem den Inhalt der Nachricht und wer sie gesendet hat. Chat-Apps Referenznutzer beim Abrufen von Informationen zu Chat-Ressourcen.

Um den Nutzer zu identifizieren, der mit einer Chat-App interagiert hat, den Wert der name-Eigenschaft der Ressource: User Sie erhalten diese Event.user.name

Das folgende JSON-Beispiel zeigt das erwartete Format der Nutzeridentität in einem Interaktion mit einer Chat-App:

{
  ...,
  "user": {
    "name": "users/12345678901234567890",
    "displayName": "Sasha",
    "avatarUrl": "https://lh3.googleusercontent.com/.../photo.jpg",
    "email": "sasha@example.com"
  }
}

Eine Nachricht ist eine bestimmte Art der Interaktion. Um einen Nutzer zu identifizieren, der eine Nachricht an eine Chat-App senden, den Wert der name-Eigenschaft der Ressource User, mit einer der Folgendes: