In diesem Leitfaden erfahren Sie, wie Sie mithilfe der Google Meet REST API Details zu Teilnehmern abrufen, die an einer vergangenen oder aktiven Videokonferenz teilgenommen haben, sowie Informationen zu den Sitzungen.
Ein Teilnehmer ist eine Person, die an einem Anruf teilnimmt oder den Companion-Modus verwendet, sich als Zuschauer ansieht oder ein mit einem Anruf verbundenes Raumgerät ist. Es gibt eine participants
-Ressource für jede Person.
Eine Teilnehmersitzung ist eine eindeutige Sitzungs-ID, die für jedes Teilnehmer-Gerätepaar erstellt wird, das an einem Anruf teilnimmt.
Für jede Sitzung gibt es eine participantSessions
-Ressource. Wenn der Teilnehmer demselben Anruf mehrmals über dasselbe Teilnehmer-Geräte-Paar beitritt, werden ihm jeweils eindeutige Sitzungs-IDs zugewiesen.
Wenn Sie Inhaber oder Teilnehmer eines Besprechungsraums sind, können Sie die Methoden get()
und list()
sowohl für die participants
- als auch für die participantSessions
-Ressource aufrufen, um Teilnehmereinträge abzurufen.
Wenn Sie die Authentifizierung und Autorisierung mit Nutzeranmeldedaten durchführen, können Google Meet-Apps auf Nutzerdaten zugreifen und im Namen des authentifizierten Nutzers Vorgänge ausführen. Wenn Sie sich mit der domainweiten Delegierung authentifizieren, können Sie das Dienstkonto einer Anwendung für den Zugriff auf die Daten Ihrer Nutzer autorisieren, ohne dass jeder Nutzer seine Einwilligung geben muss.
Teilnehmer
In den folgenden Abschnitten wird beschrieben, wie Sie Informationen zu Teilnehmern in einem Konferenzdatensatz abrufen.
Die Ressourcen participants
werden mit dem Feld user
zusammengeführt. 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.
Beachten Sie, dass alle drei Objekte eine displayName
zurückgeben, signedinUser
aber auch eine eindeutige user
-ID, die mit der Admin SDK API und der People API interoperabel ist. Format: users/{user}
. Weitere Informationen zur Verwendung der user
-ID mit der People API findest du unter Teilnehmerdetails mit der People API abrufen.
Details zu einem Teilnehmer abrufen
Wenn Sie Details zu einem bestimmten Teilnehmer abrufen möchten, verwenden Sie die Methode get()
auf der Ressource participants
mit dem Pfadparameter name
. Wenn Sie den Namen des Teilnehmers nicht kennen, können Sie mit der Methode list()
alle Namen der Teilnehmer auflisten.
Die Methode gibt Teilnehmerdaten als Instanz einer participants
-Ressource zurück.
Das folgende Codebeispiel zeigt, wie Sie einen bestimmten Teilnehmer abrufen:
Ersetzen Sie den Teilnehmernamen durch den Namen der jeweiligen Teilnehmer-ID in einem Konferenzprotokoll.
Alle Teilnehmer auflisten
Wenn Sie Details zu allen Teilnehmern in einem Konferenzeintrag auflisten möchten, verwenden Sie die Methode list()
für die Ressource participants
mit dem Pfadparameter parent
. Format:
conferenceRecords/{conferenceRecord}
.
Die Methode gibt eine Liste der Konferenzteilnehmer zurück, sortiert nach earliestStartTime
in absteigender Reihenfolge, als Instanz einer participants
-Ressource. Informationen zum Anpassen der Seitengröße und zum Filtern der Abfrageergebnisse finden Sie unter Paginierung anpassen oder Teilnehmerliste filtern.
Im folgenden Codebeispiel wird gezeigt, wie alle Teilnehmer in einem Konferenzprotokoll aufgelistet werden:
Ersetzen Sie den übergeordneten Wert durch den Namen des Konferenz-Eintrags.
Paginierung anpassen oder Teilnehmerliste filtern
Mit den folgenden Abfrageparametern kannst du die Paginierung anpassen oder Teilnehmer filtern:
pageSize
: Die maximale Anzahl der Teilnehmer, die zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 100 Teilnehmer zurückgegeben. Der Höchstwert ist 250. Werte über 250 werden automatisch in 250 geändert.pageToken
: Ein Seitentoken, das von einem vorherigen Listenaufruf empfangen wurde. Geben Sie dieses Token an, um die nachfolgende Seite abzurufen.filter
: Optional. Ein Abfragefilter zum Abrufen bestimmter Elemente in denparticipants
-Ressourcenergebnissen.Mit den Feldern
earliestStartTime
oderlatestEndTime
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 alle aktiven Teilnehmer einer bestehenden Konferenz auflisten.
Teilnehmerdetails mit der People API abrufen
Wenn Sie Details zu einem Teilnehmer abrufen möchten, verwenden Sie die Methode get()
für die Ressource people
in der People API.
Extrahieren Sie die ID der Person aus der
participant
-Ressource mithilfe der letzten Komponente des Pfads. Wenn der Ressourcenwert fürparticipant
beispielsweiseconferenceRecords/abc-123/participants/12345
ist, lautet die ID für die People API12345
.Fügen Sie die Attribute
READ_SOURCE_TYPE_PROFILE
,READ_SOURCE_TYPE_CONTACT
undREAD_SOURCE_TYPE_OTHER_CONTACT
sowieReadSourceType
hinzu. So werden sowohl interne Nutzer einer Google Workspace-Organisation als auch externe Kontakte in die Antwort einbezogen.
Im folgenden Codebeispiel wird gezeigt, wie Sie sowohl in Organisationsprofilen als auch in Kontakten nach einer Person suchen:
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
Ersetzen Sie Folgendes:
- PERSON_ID: Die ID der Person, die gefunden werden soll.
- ACCESS_TOKEN: das Zugriffstoken, das Zugriff auf mehrere APIs gewährt.
Teilnehmersitzungen
In den folgenden Abschnitten wird beschrieben, wie Sie Informationen zu den Teilnehmersitzungen eines Teilnehmers in einem Konferenzdatensatz abrufen.
Details zu einer Teilnehmersitzung abrufen
Wenn Sie Details zu einer bestimmten Teilnehmersitzung abrufen möchten, verwenden Sie die Methode get()
für die Ressource participantSessions
mit dem Pfadparameter name
. Wenn Sie den Namen der Teilnehmersitzung nicht kennen, können Sie mit der Methode list()
alle Teilnehmersitzungen eines Teilnehmers auflisten.
Die Methode gibt den Namen eines Teilnehmers als Instanz einer participantSessions
-Ressource zurück.
Das folgende Codebeispiel zeigt, wie eine bestimmte Teilnehmersitzung abgerufen wird:
Ersetzen Sie den Teilnehmernamen durch den Namen der Teilnehmersitzungs-ID in einer Teilnehmersitzung.
Alle Teilnehmersitzungen auflisten
Wenn Sie Details zu allen Teilnehmersitzungen eines Teilnehmers in einem Konferenzprotokoll auflisten möchten, verwenden Sie die Methode list()
für die Ressource participantSessions
mit dem Pfadparameter parent
. Format:
conferenceRecords/{conferenceRecord}/participants/{participant}
.
Die Methode gibt eine Liste der Teilnehmersitzungen zurück, sortiert nach startTime
in absteigender Reihenfolge, als Instanz einer participantSession
-Ressource. Informationen zum Anpassen der Seitengröße und zum Filtern der Suchergebnisse finden Sie unter Paginierung anpassen oder Teilnehmersitzungen filtern.
Im folgenden Codebeispiel wird gezeigt, wie alle Teilnehmersitzungen in einem Konferenzprotokoll aufgelistet werden:
Ersetzen Sie den übergeordneten Wert durch den Namen der Teilnehmersitzungen eines Teilnehmers in einem Konferenzprotokoll.
Paginierung anpassen oder Teilnehmersitzungen filtern
Übergeben Sie die folgenden optionalen Abfrageparameter, um die Paginierung von Teilnehmersitzungen anzupassen oder zu filtern:
pageSize
: Die maximale Anzahl der Teilnehmersitzungen, die zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 100 Teilnehmersitzungen zurückgegeben. Der Maximalwert ist 250. Werte über 250 werden automatisch in 250 geändert.pageToken
: Ein Seitentoken, das von einem vorherigen Listenaufruf empfangen wurde. Geben Sie dieses Token an, um die nachfolgende Seite abzurufen.filter
: Optional. Ein Abfragefilter zum Abrufen bestimmter Elemente in denparticipants
-Ressourcenergebnissen.Mit den Feldern
startTime
oderendTime
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
Verwenden Sie
endTime IS NULL
, um alle aktiven Teilnehmersitzungen im Konferenzprotokoll aufzulisten.