In diesem Leitfaden wird beschrieben, wie Sie einen Besprechungsraum erstellen, abrufen und aktualisieren und eine aktive Videokonferenz in der spaces-Ressource der Google Meet REST API beenden.
Konferenzraum erstellen
Verwenden Sie zum Erstellen eines Konferenzraums die Methode create für die Ressource spaces.
Die Methode gibt eine Instanz einer spaces-Ressource zurück, die das SpaceConfig-Objekt enthält, das die Konfiguration für den Konferenzraum ist. Sie enthält auch das ActiveConference-Objekt, das einen Link zur aktuellen conferenceRecords-Ressource im Besprechungsbereich enthält.
Das folgende Codebeispiel zeigt, wie Sie einen Konferenzraum erstellen:
Java
Node.js
Python
Apps Script
function createMeetingSpace() {
const response = UrlFetchApp.fetch(
'https://meet.googleapis.com/v2/spaces',
{
method: 'post',
contentType: 'application/json',
headers: {
Authorization: 'Bearer ' + ScriptApp.getOAuthToken(),
},
payload: JSON.stringify({}),
}
);
const space = JSON.parse(response.getContentText());
Logger.log('Space name: ' + space.name);
Logger.log('Meeting URI: ' + space.meetingUri);
return space;
}
cURL
curl -X POST "https://meet.googleapis.com/v2/spaces" \
-H "Authorization: Bearer ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
Ersetzen Sie ACCESS_TOKEN durch das Zugriffstoken, das Zugriff auf die API gewährt.
Konferenzraum reservieren
Wenn Sie Details zu einem aktiven Konferenzraum und seinen Einstellungen abrufen möchten, verwenden Sie die Methode get für die Ressource spaces. Legen Sie den Pfad-Parameter name im Format spaces/{space} oder spaces/{meetingCode} fest. Weitere Informationen
Die Methode gibt einen Konferenzraum als Instanz der Ressource spaces zurück. Prüfen Sie das Feld activeConference, um festzustellen, ob eine aktive Videokonferenz vorhanden ist.
Das folgende Codebeispiel zeigt, wie Sie einen Konferenzraum abrufen:
Java
Node.js
Python
Apps Script
function getMeetingSpace(spaceName) {
// spaceName format: "spaces/{space}" or "spaces/{meetingCode}"
const response = UrlFetchApp.fetch(
`https://meet.googleapis.com/v2/${spaceName}`,
{
method: 'get',
headers: {
Authorization: 'Bearer ' + ScriptApp.getOAuthToken(),
},
}
);
const space = JSON.parse(response.getContentText());
Logger.log('Space name: ' + space.name);
Logger.log('Meeting URI: ' + space.meetingUri);
if (space.activeConference) {
Logger.log('Active conference: ' +
space.activeConference.conferenceRecord);
}
return space;
}
cURL
curl -X GET "https://meet.googleapis.com/v2/spaces/SPACE_NAME" \
-H "Authorization: Bearer ACCESS_TOKEN"
Ersetzen Sie ACCESS_TOKEN durch das Zugriffstoken, das Zugriff auf die API gewährt.
Ersetzen Sie den Wert für den Namen des Bereichs durch die eindeutige, vom Server generierte ID für den Besprechungsbereich.
Konferenzraum aktualisieren
Wenn Sie die Details eines Konferenzraums aktualisieren möchten, verwenden Sie die Methode patch für die Ressource spaces. Legen Sie den Pfad-Parameter space.name im Format spaces/{space} fest. Weitere Informationen finden Sie unter So identifiziert Meet einen Besprechungsraum.
Die Methode patch verwendet auch den optionalen Abfrageparameter updateMask. Das Feld hat den Typ FieldMask.
Dies ist eine durch Kommas getrennte Liste der Felder, die Sie im Bereich aktualisieren möchten.
Die Methode gibt einen Konferenzraum als Instanz der Ressource spaces zurück.
Das folgende Codebeispiel zeigt, wie ein Konferenzraum aktualisiert wird:
Java
Node.js
Python
Apps Script
function updateMeetingSpace(spaceName) {
// spaceName format: "spaces/{space}"
const baseUrl = 'https://meet.googleapis.com/v2/';
const mask = 'updateMask=config.accessType';
const url = `${baseUrl}${spaceName}?${mask}`;
const response = UrlFetchApp.fetch(url, {
method: 'patch',
contentType: 'application/json',
headers: {
Authorization: 'Bearer ' + ScriptApp.getOAuthToken(),
},
payload: JSON.stringify({
config: {
accessType: 'RESTRICTED',
},
}),
});
const space = JSON.parse(response.getContentText());
Logger.log('Updated space: ' + space.name);
return space;
}
cURL
curl -X PATCH "https://meet.googleapis.com/v2/spaces/SPACE_NAME?updateMask=config.accessType" \
-H "Authorization: Bearer ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"config": {
"accessType": "RESTRICTED"
}
}'
Ersetzen Sie ACCESS_TOKEN durch das Zugriffstoken, das Zugriff auf die API gewährt.
Ersetzen Sie den Wert für den Namen des Bereichs durch die eindeutige, vom Server generierte ID für den Besprechungsbereich.
Aktive Konferenz beenden
Wenn Sie eine aktive Videokonferenz in einem Konferenzraum (falls vorhanden) beenden möchten, verwenden Sie die Methode endActiveConference für die Ressource spaces.
Legen Sie den Pfad-Parameter name im Format spaces/{space} fest. Sowohl der Anfrage- als auch der Antworttext sind leer. Weitere Informationen finden Sie unter So identifiziert Meet einen Besprechungsraum.
Das folgende Codebeispiel zeigt, wie eine aktive Videokonferenz beendet wird:
Java
Node.js
Python
Apps Script
function endActiveConference(spaceName) {
// spaceName format: "spaces/{space}"
const url =
`https://meet.googleapis.com/v2/${spaceName}:endActiveConference`;
UrlFetchApp.fetch(url, {
method: 'post',
contentType: 'application/json',
headers: {
Authorization: 'Bearer ' + ScriptApp.getOAuthToken(),
},
payload: JSON.stringify({}),
});
Logger.log(`Ended active conference in ${spaceName}`);
}
cURL
curl -X POST "https://meet.googleapis.com/v2/spaces/SPACE_NAME:endActiveConference" \
-H "Authorization: Bearer ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
Ersetzen Sie ACCESS_TOKEN durch das Zugriffstoken, das Zugriff auf die API gewährt.
Ersetzen Sie den Wert für den Namen des Bereichs durch die eindeutige, vom Server generierte ID für den Besprechungsbereich.
Weitere Informationen
- Übersicht über Besprechungsräume in Google Meet
- Konferenzraumeinstellungen konfigurieren
- Mitglieder von Konferenzräumen verwalten
- Mit Videokonferenzen arbeiten