Ein Teilnehmer ist eine Person, die an einem Anruf teilnimmt oder den Companion-Modus verwendet, als Zuschauer zusieht oder ein mit einem Anruf verbundenes Raumgerät nutzt. Es gibt eine conferenceRecords.participants
-Ressource für jede Person.
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. Wenn der Teilnehmer demselben Anruf mehrmals über dasselbe Teilnehmer-Geräte-Paar beitritt, werden ihm jeweils eindeutige Sitzungs-IDs zugewiesen.
Auf dieser Seite wird beschrieben, wie Sie Informationen zu allen Teilnehmern abrufen, die an einer Konferenz teilgenommen haben oder teilnehmen, oder zu einem einzelnen Teilnehmer zusammen mit den Sitzungsinformationen.
Teilnehmer
In den folgenden Abschnitten wird beschrieben, wie Sie Informationen zu Teilnehmern abrufen.
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 Computer, ein Mobilgerät oder den Companion-Modus teilnimmt.
Ein Roboterkonto, das von 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 Telefon einwählt, bei dem seine Identität unbekannt ist, da er sich nicht mit einem Google-Konto angemeldet hat.
Nach allen Teilnehmern suchen
Wenn Sie Details zu allen Teilnehmern in einem Konferenzeintrag abrufen möchten, verwenden Sie die Methode list()
für die Ressource conferenceRecords.participants
mit dem Pfadparameter parent
.
Mit den Feldern earliestStartTime
oder latestEndTime
können Sie nach Nutzern filtern, die vor oder nach einem bestimmten Zeitpunkt beigetreten sind. Für beide Felder wird das Zeitstempel-Format im RFC 3339-UTC-„Zulu“-Format mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen verwendet:
{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z
. Beispiel:
earliestStartTime < 2023-10-01T15:01:23Z
latestEndTime < 2023-10-01T15:01:23Z
Mit latestEndTime IS
NULL
können Sie die aktiven Teilnehmer einer bestehenden Konferenz abrufen.
Die Methode gibt eine Liste der Konferenzteilnehmer zurück, sortiert nach dem Zeitpunkt des Beitritts in absteigender Reihenfolge, als Instanz einer conferenceRecords.participants
-Ressource.
Im folgenden Codebeispiel wird gezeigt, wie alle Teilnehmer in einem Konferenzprotokoll aufgelistet werden:
Java
Node.js
Python
Ersetzen Sie den übergeordneten Wert durch den Namen des Konferenz-Eintrags.
Nach einem bestimmten Teilnehmer suchen
Wenn Sie nach einem bestimmten Teilnehmer suchen möchten, verwenden Sie die Methode get()
für die Ressource conferenceRecords.participants
mit dem Pfadparameter name
. Verwenden Sie die Methode conferenceRecords.participants.list
, um den Namen des Teilnehmers abzurufen.
Die Methode gibt den Namen eines Teilnehmers als Instanz einer conferenceRecords.participants
-Ressource zurück.
Das folgende Codebeispiel zeigt, wie Sie einen bestimmten Teilnehmer abrufen:
Java
Node.js
Python
Ersetzen Sie den Teilnehmernamen durch den Namen des Teilnehmers, den Sie suchen möchten.
Teilnehmersitzungen
In den folgenden Abschnitten wird beschrieben, wie Sie Informationen zu Teilnehmersitzungen abrufen.
Nach allen Sitzungen von Teilnehmern 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 den Feldern startTime
oder endTime
können Sie nach Nutzern filtern, die vor oder nach einem bestimmten Zeitraum beigetreten sind. Für beide Felder wird das Zeitstempel-Format im RFC 3339-UTC-"Zulu"-Format mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen verwendet:
{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 Beitritts in absteigender Reihenfolge, als Instanz einer conferenceRecords.participants.participantSession
-Ressource.
Im folgenden Codebeispiel wird gezeigt, wie alle Teilnehmersitzungen in einem Konferenzprotokoll aufgelistet werden:
Java
Node.js
Python
Ersetzen Sie den übergeordneten Wert durch den Namen des Konferenz-Eintrags und den Namen des Teilnehmers.
Nach einer bestimmten Teilnehmersitzung suchen
Wenn du nach einer bestimmten Teilnehmersitzung suchen möchtest, verwende die Methode get()
für die Ressource conferenceRecords.participants.participantSessions
mit dem Pfadparameter name
. Verwenden Sie die Methode list()
, um den Namen des Teilnehmers abzurufen.
Die Methode gibt den Namen eines Teilnehmers 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 Teilnehmernamen durch den Namen des Teilnehmers, den Sie suchen möchten.
Teilnehmerdetails mit der People API abrufen
Wenn Sie Details zu einem Teilnehmer abrufen möchten, verwenden Sie die Methode people.get
in der People API.
- Extrahieren Sie die ID der Person aus dem Ressourcennamen des Teilnehmers anhand der letzten Komponente des Pfads. Wenn der Name der Teilnehmerressource beispielsweise
conferenceRecords/abc-123/participants/12345
lautet, ist die ID für die People API12345
. - Fügen Sie die Quellen
READ_SOURCE_TYPE_PROFILE
,READ_SOURCE_TYPE_CONTACT
undREAD_SOURCE_TYPE_OTHER_CONTACT
hinzu. So werden sowohl interne Nutzer einer Google Workspace-Organisation als auch externe Kontakte in die Antwort einbezogen.
Im folgenden Beispiel wird sowohl in Organisationsprofilen als auch in Kontakten nach einer Person gesucht:
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