このガイドでは、Google Meet REST API の spaces リソースで会議スペースを作成、取得、更新し、アクティブな会議を終了する方法について説明します。
会議スペースを作成する
会議スペースを作成するには、spaces リソースで create メソッドを使用します。
このメソッドは、会議スペースの構成である SpaceConfig オブジェクトを含む spaces リソースのインスタンスを返します。また、会議スペース内の現在の conferenceRecords リソースへのリンクである ActiveConference オブジェクトも含まれています。
次のコードサンプルは、会議スペースを作成する方法を示しています。
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 '{}'
ACCESS_TOKEN は、API へのアクセス権を付与するアクセス トークンに置き換えます。
会議スペースを確保する
アクティブな会議スペースとその設定の詳細を取得するには、spaces リソースで get メソッドを使用します。spaces/{space} または spaces/{meetingCode} の形式を使用して、name パスパラメータを設定します。詳しくは、Meet で会議室を識別する方法をご覧ください。
このメソッドは、spaces リソースのインスタンスとして会議スペースを返します。アクティブな会議が存在するかどうかを判断するには、activeConference フィールドを調べます。
次のコードサンプルは、会議スペースを取得する方法を示しています。
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"
ACCESS_TOKEN は、API へのアクセス権を付与するアクセス トークンに置き換えます。
スペース名の値は、会議スペースの一意のサーバー生成 ID に置き換えます。
会議スペースを更新する
会議スペースの詳細を更新するには、spaces リソースで patch メソッドを使用します。spaces/{space} の形式で space.name パスパラメータを設定します。詳しくは、Meet で会議室を識別する方法をご覧ください。
patch メソッドは、オプションの updateMask クエリ パラメータも受け取ります。フィールドの型は FieldMask です。これは、スペースで更新するフィールドのカンマ区切りのリストです。
このメソッドは、spaces リソースのインスタンスとして会議スペースを返します。
次のコードサンプルは、会議スペースを更新する方法を示しています。
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"
}
}'
ACCESS_TOKEN は、API へのアクセス権を付与するアクセス トークンに置き換えます。
スペース名の値は、会議スペースの一意のサーバー生成 ID に置き換えます。
アクティブな会議を終了する
会議スペース内でアクティブな会議を終了するには（会議スペースがある場合）、spaces リソースの endActiveConference メソッドを使用します。spaces/{space} の形式で name パスパラメータを設定します。リクエストとレスポンスの本文は両方とも空です。詳しくは、Meet で会議室を特定する方法をご覧ください。
次のコードサンプルは、アクティブな会議を終了する方法を示しています。
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 '{}'
ACCESS_TOKEN は、API へのアクセス権を付与するアクセス トークンに置き換えます。
スペース名の値は、会議スペースの一意のサーバー生成 ID に置き換えます。