本指南介绍了如何在 Google Meet REST API 的 spaces
资源上创建、获取和更新会议室,以及结束正在进行的会议。
创建会议空间
如需创建会议室,请对 spaces
资源使用 create
方法。
该方法会返回 spaces
资源的实例,其中包含会议室配置的 SpaceConfig
对象。它还包含 ActiveConference
对象,该对象是指向会议室内当前 conferenceRecords
资源的链接。
以下代码示例展示了如何创建会议室:
Java
import com.google.api.core.ApiFuture; import com.google.apps.meet.v2.CreateSpaceRequest; import com.google.apps.meet.v2.Space; import com.google.apps.meet.v2.SpacesServiceClient; public class AsyncCreateSpace { public static void main(String[] args) throws Exception { asyncCreateSpace(); } public static void asyncCreateSpace() throws Exception { // This snippet has been automatically generated and should be regarded as a code template only. // It will require modifications to work: // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library try (SpacesServiceClient spacesServiceClient = SpacesServiceClient.create()) { CreateSpaceRequest request = CreateSpaceRequest.newBuilder().setSpace(Space.newBuilder().build()).build(); ApiFuture<Space> future = spacesServiceClient.createSpaceCallable().futureCall(request); // Do something. Space response = future.get(); } } }
Node.js
/** * This snippet has been automatically generated and should be regarded as a code template only. * It will require modifications to work. * It may require correct/in-range values for request initialization. * TODO(developer): Uncomment these variables before running the sample. */ /** * Space to be created. As of May 2023, the input space can be empty. Later on * the input space can be non-empty when space configuration is introduced. */ // const space = {} // Imports the Meet library const {SpacesServiceClient} = require('@google-apps/meet').v2; // Instantiates a client const meetClient = new SpacesServiceClient(); async function callCreateSpace() { // Construct request const request = { }; // Run request const response = await meetClient.createSpace(request); console.log(response); } callCreateSpace();
Python
# This snippet has been automatically generated and should be regarded as a # code template only. # It will require modifications to work: # - It may require correct/in-range values for request initialization. # - It may require specifying regional endpoints when creating the service # client as shown in: # https://googleapis.dev/python/google-api-core/latest/client_options.html from google.apps import meet_v2 async def sample_create_space(): # Create a client client = meet_v2.SpacesServiceAsyncClient() # Initialize request argument(s) request = meet_v2.CreateSpaceRequest( ) # Make the request response = await client.create_space(request=request) # Handle the response print(response)
获取会议室的详细信息
如需获取有关有效会议室及其设置的详细信息,请对 spaces
资源使用 get
方法,并指定 name
。如需了解详情,请参阅 Meet 如何识别会议空间。
该方法会将会议室作为 spaces
资源的实例返回。如需确定是否存在有效的会议,请检查 activeConference
字段。
以下代码示例展示了如何检索会议室:
Java
import com.google.api.core.ApiFuture; import com.google.apps.meet.v2.GetSpaceRequest; import com.google.apps.meet.v2.Space; import com.google.apps.meet.v2.SpaceName; import com.google.apps.meet.v2.SpacesServiceClient; public class AsyncGetSpace { public static void main(String[] args) throws Exception { asyncGetSpace(); } public static void asyncGetSpace() throws Exception { // This snippet has been automatically generated and should be regarded as a code template only. // It will require modifications to work: // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library try (SpacesServiceClient spacesServiceClient = SpacesServiceClient.create()) { GetSpaceRequest request = GetSpaceRequest.newBuilder().setName(SpaceName.of("[SPACE]").toString()).build(); ApiFuture<Space> future = spacesServiceClient.getSpaceCallable().futureCall(request); // Do something. Space response = future.get(); } } }
Node.js
/** * This snippet has been automatically generated and should be regarded as a code template only. * It will require modifications to work. * It may require correct/in-range values for request initialization. * TODO(developer): Uncomment these variables before running the sample. */ /** * Required. Resource name of the space. * Format: `spaces/{space}` or `spaces/{meetingCode}`. * `{space}` is the resource identifier for the space. It's a unique, * server-generated ID and is case sensitive. For example, `jQCFfuBOdN5z`. * `{meetingCode}` is an alias for the space. It's a typeable, unique * character string and is non-case sensitive. For example, `abc-mnop-xyz`. * The maximum length is 128 characters. * A `meetingCode` shouldn't be stored long term as it can become * dissociated from a meeting space and can be reused for different meeting * spaces in the future. Generally, a `meetingCode` expires 365 days after * last use. For more information, see Learn about meeting codes in Google * Meet (https://support.google.com/meet/answer/10710509). * For more information, see How Meet identifies a meeting * space (https://developers.google.com/meet/api/guides/meeting-spaces#identify-meeting-space). */ // const name = 'abc123' // Imports the Meet library const {SpacesServiceClient} = require('@google-apps/meet').v2; // Instantiates a client const meetClient = new SpacesServiceClient(); async function callGetSpace() { // Construct request const request = { name, }; // Run request const response = await meetClient.getSpace(request); console.log(response); } callGetSpace();
Python
# This snippet has been automatically generated and should be regarded as a # code template only. # It will require modifications to work: # - It may require correct/in-range values for request initialization. # - It may require specifying regional endpoints when creating the service # client as shown in: # https://googleapis.dev/python/google-api-core/latest/client_options.html from google.apps import meet_v2 async def sample_get_space(): # Create a client client = meet_v2.SpacesServiceAsyncClient() # Initialize request argument(s) request = meet_v2.GetSpaceRequest( name="name_value", ) # Make the request response = await client.get_space(request=request) # Handle the response print(response)
将聊天室名称值替换为会议聊天室的唯一服务器生成 ID。
更新会议空间
如需更新会议室的详细信息,请对 spaces
资源使用 patch
方法,并指定 name
。如需了解详情,请参阅 Meet 如何识别会议空间。
patch
方法还接受可选的 updateMask
查询参数。该字段的类型为 FieldMask
。这是您要更新的聊天室中字段的逗号分隔列表。
该方法会将会议室作为 spaces
资源的实例返回。
以下代码示例展示了如何更新会议室:
Java
import com.google.api.core.ApiFuture; import com.google.apps.meet.v2.Space; import com.google.apps.meet.v2.SpacesServiceClient; import com.google.apps.meet.v2.UpdateSpaceRequest; import com.google.protobuf.FieldMask; public class AsyncUpdateSpace { public static void main(String[] args) throws Exception { asyncUpdateSpace(); } public static void asyncUpdateSpace() throws Exception { // This snippet has been automatically generated and should be regarded as a code template only. // It will require modifications to work: // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library try (SpacesServiceClient spacesServiceClient = SpacesServiceClient.create()) { UpdateSpaceRequest request = UpdateSpaceRequest.newBuilder() .setSpace(Space.newBuilder().build()) .setUpdateMask(FieldMask.newBuilder().build()) .build(); ApiFuture<Space> future = spacesServiceClient.updateSpaceCallable().futureCall(request); // Do something. Space response = future.get(); } } }
Node.js
/** * This snippet has been automatically generated and should be regarded as a code template only. * It will require modifications to work. * It may require correct/in-range values for request initialization. * TODO(developer): Uncomment these variables before running the sample. */ /** * Required. Space to be updated. */ // const space = {} /** * Optional. Field mask used to specify the fields to be updated in the space. * If update_mask isn't provided(not set, set with empty paths, or only has "" * as paths), it defaults to update all fields provided with values in the * request. * Using "*" as update_mask will update all fields, including deleting fields * not set in the request. */ // const updateMask = {} // Imports the Meet library const {SpacesServiceClient} = require('@google-apps/meet').v2; // Instantiates a client const meetClient = new SpacesServiceClient(); async function callUpdateSpace() { // Construct request const request = { space, }; // Run request const response = await meetClient.updateSpace(request); console.log(response); } callUpdateSpace();
Python
# This snippet has been automatically generated and should be regarded as a # code template only. # It will require modifications to work: # - It may require correct/in-range values for request initialization. # - It may require specifying regional endpoints when creating the service # client as shown in: # https://googleapis.dev/python/google-api-core/latest/client_options.html from google.apps import meet_v2 async def sample_update_space(): # Create a client client = meet_v2.SpacesServiceAsyncClient() # Initialize request argument(s) request = meet_v2.UpdateSpaceRequest( ) # Make the request response = await client.update_space(request=request) # Handle the response print(response)
将聊天室名称值替换为会议聊天室的唯一服务器生成 ID。
结束正在进行的会议
如需结束会议室内正在进行的会议(如果有),请对 spaces
资源使用 endActiveConference
方法。请求正文和响应正文均为空。如需了解详情,请参阅Meet 如何识别会议空间。
以下代码示例展示了如何结束正在进行的会议:
Java
import com.google.api.core.ApiFuture; import com.google.apps.meet.v2.EndActiveConferenceRequest; import com.google.apps.meet.v2.SpaceName; import com.google.apps.meet.v2.SpacesServiceClient; import com.google.protobuf.Empty; public class AsyncEndActiveConference { public static void main(String[] args) throws Exception { asyncEndActiveConference(); } public static void asyncEndActiveConference() throws Exception { // This snippet has been automatically generated and should be regarded as a code template only. // It will require modifications to work: // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library try (SpacesServiceClient spacesServiceClient = SpacesServiceClient.create()) { EndActiveConferenceRequest request = EndActiveConferenceRequest.newBuilder() .setName(SpaceName.of("[SPACE]").toString()) .build(); ApiFuture<Empty> future = spacesServiceClient.endActiveConferenceCallable().futureCall(request); // Do something. future.get(); } } }
Node.js
/** * This snippet has been automatically generated and should be regarded as a code template only. * It will require modifications to work. * It may require correct/in-range values for request initialization. * TODO(developer): Uncomment these variables before running the sample. */ /** * Required. Resource name of the space. * Format: `spaces/{space}`. * `{space}` is the resource identifier for the space. It's a unique, * server-generated ID and is case sensitive. For example, `jQCFfuBOdN5z`. * For more information, see How Meet identifies a meeting * space (https://developers.google.com/meet/api/guides/meeting-spaces#identify-meeting-space). */ // const name = 'abc123' // Imports the Meet library const {SpacesServiceClient} = require('@google-apps/meet').v2; // Instantiates a client const meetClient = new SpacesServiceClient(); async function callEndActiveConference() { // Construct request const request = { name, }; // Run request const response = await meetClient.endActiveConference(request); console.log(response); } callEndActiveConference();
Python
# This snippet has been automatically generated and should be regarded as a # code template only. # It will require modifications to work: # - It may require correct/in-range values for request initialization. # - It may require specifying regional endpoints when creating the service # client as shown in: # https://googleapis.dev/python/google-api-core/latest/client_options.html from google.apps import meet_v2 async def sample_end_active_conference(): # Create a client client = meet_v2.SpacesServiceAsyncClient() # Initialize request argument(s) request = meet_v2.EndActiveConferenceRequest( name="name_value", ) # Make the request await client.end_active_conference(request=request)
将聊天室名称值替换为会议聊天室由服务器生成的唯一 ID。