Ein Teilnehmer ist eine Person, die einem
oder die Companion
als Zuschauer ansehen
ein Gerät in einem Raum, das mit einem Anruf verbunden ist. Es gibt eine
conferenceRecords.participants
Ressource für jede Person.
Eine Teilnehmersitzung ist eine
eindeutige Sitzungs-ID, die für jedes Teilnehmer/Gerät-Paar erstellt wird, das an einem Anruf teilnimmt.
Es gibt eine
conferenceRecords.participants.participantSessions
Ressource für jede Sitzung. Wenn der Teilnehmer mehrmals am selben Anruf teilnimmt
aus demselben Teilnehmer/Gerät-Paar
erhältst du eine eindeutige Sitzungs-ID.
Auf dieser Seite wird beschrieben, wie Sie Informationen zu allen Teilnehmern erhalten, die teilgenommen haben. oder in einer Konferenz sind oder es einzelne teilnehmende Person zusammen mit ihren Sitzungsinformationen.
Teilnehmer
In den folgenden Abschnitten wird beschrieben, wie Sie Informationen über Teilnehmende erhalten.
Die
conferenceRecords.participants
Ressource enthält das Feld user
. Für user
ist nur einer der folgenden Werte zulässig
Objekte:
signedinUser
ist entweder:Teilnahme über einen Computer, ein Mobilgerät oder im Companion-Modus.
Ein Robot-Konto, das von Konferenzraumgeräten verwendet wird.
Ein
anonymousUser
ist ein nicht identifizierter Nutzer, der nicht in einem Google-Konto angemeldet ist.phoneUser
ein Nutzer, der sich von einem Smartphone aus einwählt, dessen Identität unbekannt ist weil sie sich nicht mit einem Google-Konto angemeldet haben.
Nach allen Teilnehmern suchen
Details zu allen Teilnehmern eines Konferenzeintrags erhalten Sie über die
list()
auf der
conferenceRecords.participants
Ressource mit dem Pfadparameter parent
.
Sie können das Feld earliestStartTime
oder latestEndTime
verwenden, um nach
Nutzer, die vor oder nach einem bestimmten Zeitpunkt beigetreten sind Beide Felder verwenden das Feld
Zeitstempel
Format in RFC 3339
UTC „Zulu“ mit 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 erhalten.
Die Methode gibt eine Liste der Konferenzteilnehmer zurück, sortiert nach dem Zeitpunkt des
absteigende Reihenfolge als Instanz einer conferenceRecords.participants
-Ressource.
Das folgende Codebeispiel zeigt, wie alle Teilnehmer einer Konferenz aufgelistet werden Datensatz:
Java
Node.js
Python
Ersetzen Sie den übergeordneten Wert durch den Namen des Konferenzeintrags.
Nach einem bestimmten Teilnehmer suchen
Um nach einem bestimmten Teilnehmer zu suchen, verwenden Sie die
get()
auf der
conferenceRecords.participants
Ressource mit dem Pfadparameter name
. Um den Namen der
teilnehmen, verwenden Sie die Methode conferenceRecords.participants.list
.
Die Methode gibt einen Teilnehmernamen als Instanz eines
conferenceRecords.participants
.
Das folgende Codebeispiel zeigt, wie Sie einen bestimmten Teilnehmer abrufen:
Java
Node.js
Python
Ersetzen Sie den Namen des Teilnehmers durch den Namen des zu suchenden Teilnehmers.
Sitzungen der Teilnehmer
In den folgenden Abschnitten wird beschrieben, wie Sie Informationen zu Teilnehmersitzungen erhalten.
Nach allen Teilnehmersitzungen suchen
Um Details zu allen Teilnehmersitzungen eines Teilnehmers einer Konferenz abzurufen
verwenden Sie die
list()
auf der
conferenceRecords.participants.participantSessions
Ressource mit dem Pfadparameter parent
.
Mit den Feldern startTime
oder endTime
können Sie nach Nutzern filtern, die beigetreten sind
vor oder nach einer bestimmten Zeit wieder verlassen. Beide Felder verwenden das Feld
Zeitstempel
Format in RFC
3339 UTC
„Zulu“ mit 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 der Teilnehmersitzungen zurück, sortiert nach dem Zeitpunkt des
absteigend sortiert werden, als Instanz einer
conferenceRecords.participants.participantSession
.
Das folgende Codebeispiel zeigt, wie Sie alle Teilnehmersitzungen in einer Konferenzeintrag:
Java
Node.js
Python
Ersetzen Sie den übergeordneten Wert durch den Namen des Konferenzeintrags und den Teilnehmernamen.
Nach einer bestimmten Teilnehmersitzung suchen
Um nach einer bestimmten Teilnehmersitzung zu suchen, verwenden Sie die
get()
auf der
conferenceRecords.participants.participantSessions
Ressource mit dem Pfadparameter name
. Um den Namen der
teilnehmen, verwenden Sie die Methode list()
.
Die Methode gibt einen Teilnehmernamen als Instanz eines
conferenceRecords.participants.participantSessions
.
Das folgende Codebeispiel zeigt, wie eine bestimmte Teilnehmersitzung abgerufen wird:
Java
Node.js
Python
Ersetzen Sie den Namen des Teilnehmers durch den Namen des zu suchenden Teilnehmers.
Teilnehmerdetails mit der People API abrufen
Um Details zu einem Teilnehmer abzurufen, verwenden Sie die
people.get
-Methode in der
People API
- Extrahieren Sie die ID der Person aus dem Ressourcennamen des Teilnehmers mithilfe der
nachgestellte Komponente des Pfads. Wenn beispielsweise der Ressourcenname des Teilnehmers
ist
conferenceRecords/abc-123/participants/12345
die ID des Die People API ist12345
. - Die Quellen
READ_SOURCE_TYPE_PROFILE
,READ_SOURCE_TYPE_CONTACT
, undREAD_SOURCE_TYPE_OTHER_CONTACT
. So können sowohl interne Nutzende eine Google Workspace-Organisation und externe Kontakte sind enthalten in auf die Antwort.
Im folgenden Beispiel wird sowohl in Unternehmensprofilen als auch in Kontakten nach einem Person:
cURL
curl \
'https://people.googleapis.com/v1/people/PERSON_ID?personFields=names%2CemailAddresses&sources=READ_SOURCE_TYPE_OTHER_CONTACT&sources=READ_SOURCE_TYPE_PROFILE&sources=READ_SOURCE_TYPE_CONTACT' \
--header 'Authorization: Bearer ACCESS_TOKEN' \
--header 'Accept: application/json' \
--compressed