Ein Teilnehmer ist eine Person, die einem Anruf beigetreten ist oder den Companion-Modus verwendet, sie als Betrachter ansieht oder ein mit einem Anruf verbundenes Gerät in einem Raum nutzt. Für jede Person gibt es eine conferenceRecords.participants
-Ressource.
Eine Teilnehmersitzung ist eine eindeutige Sitzungs-ID, die für jedes Teilnehmer/Geräte-Paar erstellt wird, das an einem Anruf teilnimmt.
Für jede Sitzung gibt es eine conferenceRecords.participants.participantSessions
-Ressource. Nimmt ein Teilnehmer über dasselbe Teilnehmer-Geräte-Paar mehrmals am selben Anruf teil, wird ihm jeweils eine eindeutige Sitzungs-ID zugewiesen.
Auf dieser Seite wird beschrieben, wie Sie Informationen über alle Teilnehmer, die an einer Konferenz oder nur zu einem einzelnen Teilnehmer teilgenommen haben, zusammen mit ihren Sitzungsinformationen abrufen können.
Teilnehmer
In den folgenden Abschnitten wird beschrieben, wie Sie Informationen über Teilnehmende erhalten.
Die Ressource conferenceRecords.participants
enthält das Feld user
. Ein user
kann nur eines der folgenden Objekte sein:
Ein
signedinUser
ist entweder:Eine Person, die über einen privaten Computer, ein Mobilgerät oder im Companion-Modus teilnimmt.
Ein Roboterkonto, das auf Geräten in Konferenzräumen verwendet wird.
Ein
anonymousUser
ist ein nicht identifizierter Nutzer, der nicht in einem Google-Konto angemeldet ist.Ein
phoneUser
ist ein Nutzer, der sich über ein Smartphone einwählt, dessen Identität unbekannt ist, weil er sich nicht mit einem Google-Konto angemeldet hat.
Nach allen Teilnehmern suchen
Wenn Sie Details zu allen Teilnehmern in einem Konferenzdatensatz abrufen möchten, verwenden Sie die Methode list()
in der Ressource conferenceRecords.participants
mit dem Pfadparameter parent
.
Mit den Feldern earliestStartTime
oder latestEndTime
können Sie nach Nutzern filtern, die vor oder nach einer bestimmten Zeit beigetreten sind. Beide Felder verwenden das Format Zeitstempel im Format RFC 3339 UTC „Zulu“ mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen: {year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z
. Beispiel:
earliestStartTime < 2023-10-01T15:01:23Z
latestEndTime < 2023-10-01T15:01:23Z
Verwenden Sie latestEndTime IS
NULL
, um aktive Teilnehmer an einer vorhandenen Konferenz zu gewinnen.
Die Methode gibt eine Liste von Konferenzteilnehmern, sortiert nach Teilnahmezeit in absteigender Reihenfolge, als Instanz einer conferenceRecords.participants
-Ressource zurück.
Das folgende Codebeispiel zeigt, wie Sie alle Teilnehmer in einem Konferenzdatensatz auflisten:
Java
Node.js
Python
Ersetzen Sie den übergeordneten Wert durch den Namen des Konferenzdatensatzes.
Nach einem bestimmten Teilnehmer suchen
Wenn Sie nach einem bestimmten Teilnehmer suchen möchten, verwenden Sie die Methode get()
in der Ressource conferenceRecords.participants
mit dem Pfadparameter name
. Verwenden Sie die Methode conferenceRecords.participants.list
, um den Namen des Teilnehmers abzurufen.
Die Methode gibt einen Teilnehmernamen als Instanz einer conferenceRecords.participants
-Ressource zurück.
Das folgende Codebeispiel zeigt, wie ein bestimmter Teilnehmer abgerufen wird:
Java
Node.js
Python
Ersetzen Sie den Namen der Teilnehmenden durch den Namen der Person, die gesucht werden soll.
Teilnehmersitzungen
In den folgenden Abschnitten wird beschrieben, wie Sie Informationen über Teilnehmersitzungen erhalten.
Nach allen Teilnehmersitzungen suchen
Wenn Sie Details zu allen Teilnehmersitzungen eines Teilnehmers in einem Konferenzeintrag abrufen möchten, verwenden Sie die Methode list()
für die Ressource conferenceRecords.participants.participantSessions
mit dem Pfadparameter parent
.
Mit dem Feld startTime
oder endTime
können Sie nach Nutzern filtern, die zuvor oder nach einer bestimmten Zeit beigetreten sind. Beide Felder verwenden das Zeitstempelformat im Format RFC 3339 UTC „Zulu“ mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen: {year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z
. Beispiel:
startTime < 2023-10-01T15:01:23Z
endTime < 2023-10-01T15:01:23Z
Die Methode gibt eine Liste von Teilnehmersitzungen als Instanz einer conferenceRecords.participants.participantSession
-Ressource zurück, die nach Teilnahmezeit in absteigender Reihenfolge sortiert sind.
Das folgende Codebeispiel zeigt, wie alle Teilnehmersitzungen in einem Konferenzdatensatz aufgelistet werden:
Java
Node.js
Python
Ersetzen Sie den übergeordneten Wert durch den Namen des Konferenzeintrags und des Teilnehmers.
Nach einer bestimmten Teilnehmersitzung suchen
Wenn Sie nach einer bestimmten Teilnehmersitzung suchen möchten, verwenden Sie die Methode get()
in der Ressource conferenceRecords.participants.participantSessions
mit dem Pfadparameter name
. Verwenden Sie die Methode list()
, um den Namen des Teilnehmers abzurufen.
Die Methode gibt einen Teilnehmernamen als Instanz einer conferenceRecords.participants.participantSessions
-Ressource zurück.
Das folgende Codebeispiel zeigt, wie eine bestimmte Teilnehmersitzung abgerufen wird:
Java
Node.js
Python
Ersetzen Sie den Namen der Teilnehmenden durch den Namen der Person, die gesucht werden soll.