Auf dieser Seite wird erläutert, wie Google Chat-Apps Chat-Nutzer identifizieren oder angeben können.
Für die folgenden Aufgaben muss in einer Chat-App ein Nutzer angegeben werden:
- Erstellen Sie eine Nachricht, in der ein Nutzer mit@ erwähnt wird.
- Laden Sie einen Nutzer in einen vorhandenen Gruppenbereich ein oder fügen Sie ihn einem neuen Gruppenbereich hinzu.
- Direktnachrichten finden zwischen der Chat-App und einem bestimmten Nutzer oder zwischen zwei Nutzern.
- Mitgliederdetails eines Nutzers in einem Gruppenbereich abrufen
- Senden Sie eine private Nachricht an einen Nutzer.
Identifizierung von Nutzern in Google Chat
Die Google Chat API generiert für jede Person, die Chat verwendet, eine User
-Ressource. Im Folgenden finden Sie zwei wichtige User
-Felder:
name
ist der Ressourcenname für die Ressource im Formatusers/{user}
, wobei{user}
für eine eindeutige und stabile Kennung steht.users/app
kann als Alias für die aufrufende Chat-App verwendet werden.type
ist der Typ des Nutzers. Dieser Typ teilt Chat mit, ob der Nutzer eine Chat-App oder eine Person ist. Für Chat-Apps ist der WertBOT
. Für Personen lautet der WertHUMAN
.
Nutzer in einem Aufruf der Google Chat API angeben
Verwenden Sie die folgenden Werte für {user}
, um einen Nutzer anzugeben:
Verwenden Sie für Nutzer in Ihrer Google Workspace-Organisation einen der folgenden Ansätze:
- Der
name
der RessourceUser
in der Chat API, z. B.users/123456789
. - Die
{person_id}
für den Namen einerPerson
-Ressource in der People API, wobei dieresourceName
people/{person_id}
ist. Beispiel:users/123456789
in der Chat API steht fürpeople/123456789
in der People API. - Die
id
für eineUser
-Ressource in der Directory API, z. B.users/123456789
in der Chat API, steht für dieselbe Person wieusers/123456789
in der Directory API.
- Der
Verwenden Sie für Nutzer in einer externen Google Workspace-Organisation oder Nutzer, die ein Google-Konto verwenden, einen E-Mail-Alias, z. B.
users/EMAIL_USERNAME@WORKSPACE_DOMAIN.com
oderusers/EMAIL_USERNAME@gmail.com
.
Nutzer über ein Interaktionsereignis identifizieren
Jedes Mal, wenn ein Nutzer mit einer Chat-Anwendung interagiert, sendet Chat ein Interaktionsereignis mit Informationen zur Interaktion und zum Nutzer. Wenn ein Nutzer beispielsweise eine Chat-App in einer Nachricht erwähnt, erhält die Chat-App Informationen über die Interaktion, einschließlich der Nachricht und des Absenders. Chat-Apps verweisen beim Abrufen von Informationen zu Chat-Ressourcen auf Nutzer.
Um den Nutzer zu identifizieren, der mit einer Chat-App interagiert hat, rufen Sie den Wert des Attributs name
in der Ressource User
ab, den Sie über Event.user.name
abrufen können.
Das folgende JSON-Beispiel zeigt das erwartete Format der Nutzeridentität bei einer Interaktion mit einer Chat-Anwendung:
{
...,
"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. Wenn Sie einen Nutzer identifizieren möchten, der eine Nachricht an eine Chat-App gesendet hat, rufen Sie den Wert des Attributs name
in der Ressource User
mit einer der folgenden Methoden ab:
Weitere Informationen
- Nutzer zu Gruppenbereichen hinzufügen
- Mitglieder in einem Gruppenbereich verwalten
- Nutzer in einer Nachricht mit@ erwähnen: