Z tego przewodnika dowiesz się, jak tworzyć i aktualizować miejsce spotkania oraz jak je pobierać, a także jak kończyć aktywną konferencję w zasobie spaces interfejsu Google Meet REST API.
Tworzenie pokoju spotkań
Aby utworzyć miejsce spotkań, użyj metody create w zasobie spaces.
Metoda zwraca instancję zasobu spaces, która zawiera obiekt SpaceConfig będący konfiguracją przestrzeni do spotkań. Zawiera też obiekt
ActiveConference
będący linkiem do bieżącego
conferenceRecords
zasobu w przestrzeni spotkań.
Poniższy przykładowy kod pokazuje, jak utworzyć miejsce spotkań:
Java
Node.js
Python
Google 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 '{}'
Zastąp ACCESS_TOKEN tokenem dostępu, który przyznaje dostęp do interfejsu API.
Uzyskiwanie miejsca na spotkanie
Aby uzyskać szczegółowe informacje o aktywnym miejscu spotkań i jego ustawieniach, użyj metody get w zasobie spaces. Ustaw parametr ścieżki name w formacie spaces/{space} lub spaces/{meetingCode}. Więcej informacji znajdziesz w artykule Jak Meet identyfikuje pomieszczenie do spotkań.
Metoda zwraca miejsce spotkań jako instancję zasobu spaces. Aby sprawdzić, czy istnieje aktywna konferencja, sprawdź pole activeConference.
Poniższy przykładowy kod pokazuje, jak pobrać przestrzeń spotkań:
Java
Node.js
Python
Google 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"
Zastąp ACCESS_TOKEN tokenem dostępu, który przyznaje dostęp do interfejsu API.
Zastąp wartość nazwy pokoju unikalnym identyfikatorem wygenerowanym przez serwer dla pokoju spotkań.
Aktualizowanie pokoju spotkań
Aby zaktualizować szczegóły miejsca spotkań, użyj metody patch w zasobie spaces. Ustaw parametr ścieżki space.name w formacie spaces/{space}. Więcej informacji znajdziesz w artykule Jak Meet identyfikuje pomieszczenie do spotkań.
Metoda patch przyjmuje też opcjonalny parametr zapytania updateMask. Pole jest typu FieldMask.
Jest to lista rozdzielonych przecinkami pól, które chcesz zaktualizować w przestrzeni.
Metoda zwraca miejsce spotkań jako instancję zasobu spaces.
Poniższy przykładowy kod pokazuje, jak zaktualizować miejsce spotkań:
Java
Node.js
Python
Google 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"
}
}'
Zastąp ACCESS_TOKEN tokenem dostępu, który przyznaje dostęp do interfejsu API.
Zastąp wartość nazwy pokoju unikalnym identyfikatorem wygenerowanym przez serwer dla pokoju spotkań.
Kończenie aktywnej konferencji
Aby zakończyć aktywną konferencję w przestrzeni spotkań (jeśli taka istnieje), użyj metody
endActiveConference
w zasobie spaces.
Ustaw parametr ścieżki name w formacie spaces/{space}. Zarówno treść żądania, jak i treść odpowiedzi są puste. Więcej informacji znajdziesz w artykule Jak Meet identyfikuje pomieszczenie do spotkań.
Poniższy przykładowy kod pokazuje, jak zakończyć aktywną konferencję:
Java
Node.js
Python
Google 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 '{}'
Zastąp ACCESS_TOKEN tokenem dostępu, który przyznaje dostęp do interfejsu API.
Zastąp wartość nazwy pokoju unikalnym identyfikatorem wygenerowanym przez serwer dla pokoju spotkań.
Powiązane artykuły
- Omówienie przestrzeni spotkań w Google Meet
- Konfigurowanie ustawień miejsca spotkań
- Zarządzanie osobami w pokoju spotkań
- Praca z konferencjami