处理会议

本指南介绍了如何获取 Google Meet REST API 的 conferenceRecords 资源中有关单个会议或所有会议的详细信息。

会议是会议空间内由服务器生成的通话实例。它也是会议的单个实例。

如果您是会议室所有者或参与者,可以调用 get()list() 方法来检索会议记录。

通过用户凭据进行身份验证和授权后,Google Meet 应用可以访问用户数据,并代表经过身份验证的用户执行操作。通过全网域授权进行身份验证后,您便可授权应用的某个服务账号访问您用户的数据,而无需经过每位用户的同意。

获取有关会议的详细信息

如需获取特定会议的详细信息,请对 conferenceRecords 资源使用 get() 方法,并提供会议 name 路径参数。如果您不知道会议名称,可以使用 list() 方法列出所有会议名称

该方法会以 conferenceRecords 资源实例的形式返回过往会议。

以下代码示例展示了如何检索特定会议:

Java

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/getconferencerecord/AsyncGetConferenceRecord.java
import com.google.api.core.ApiFuture; import com.google.apps.meet.v2.ConferenceRecord; import com.google.apps.meet.v2.ConferenceRecordName; import com.google.apps.meet.v2.ConferenceRecordsServiceClient; import com.google.apps.meet.v2.GetConferenceRecordRequest;  public class AsyncGetConferenceRecord {    public static void main(String[] args) throws Exception {     asyncGetConferenceRecord();   }    public static void asyncGetConferenceRecord() 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 (ConferenceRecordsServiceClient conferenceRecordsServiceClient =         ConferenceRecordsServiceClient.create()) {       GetConferenceRecordRequest request =           GetConferenceRecordRequest.newBuilder()               .setName(ConferenceRecordName.of("[CONFERENCE_RECORD]").toString())               .build();       ApiFuture<ConferenceRecord> future =           conferenceRecordsServiceClient.getConferenceRecordCallable().futureCall(request);       // Do something.       ConferenceRecord response = future.get();     }   } }

Node.js

packages/google-apps-meet/samples/generated/v2/conference_records_service.get_conference_record.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 conference.  */ // const name = 'abc123'  // Imports the Meet library const {ConferenceRecordsServiceClient} = require('@google-apps/meet').v2;  // Instantiates a client const meetClient = new ConferenceRecordsServiceClient();  async function callGetConferenceRecord() {   // Construct request   const request = {     name,   };    // Run request   const response = await meetClient.getConferenceRecord(request);   console.log(response); }  callGetConferenceRecord();

Python

packages/google-apps-meet/samples/generated_samples/meet_v2_generated_conference_records_service_get_conference_record_async.py
# 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_conference_record():     # Create a client     client = meet_v2.ConferenceRecordsServiceAsyncClient()      # Initialize request argument(s)     request = meet_v2.GetConferenceRecordRequest(         name="name_value",     )      # Make the request     response = await client.get_conference_record(request=request)      # Handle the response     print(response)

将会议记录名称替换为会议记录中特定会议 ID 的名称。

列出所有会议

如需列出所有会议的详细信息,请对 conferenceRecords 资源使用 list() 方法,而不使用任何路径参数。

该方法会以 conferenceRecords 资源实例的形式返回过往会议的列表。这些信息会过滤到会议组织者,并按 startTime 降序排序。如需调整页面大小和过滤查询结果,请参阅自定义分页或过滤列表

以下代码示例展示了如何列出所有会议:

Java

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/listconferencerecords/AsyncListConferenceRecords.java
import com.google.api.core.ApiFuture; import com.google.apps.meet.v2.ConferenceRecord; import com.google.apps.meet.v2.ConferenceRecordsServiceClient; import com.google.apps.meet.v2.ListConferenceRecordsRequest;  public class AsyncListConferenceRecords {    public static void main(String[] args) throws Exception {     asyncListConferenceRecords();   }    public static void asyncListConferenceRecords() 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 (ConferenceRecordsServiceClient conferenceRecordsServiceClient =         ConferenceRecordsServiceClient.create()) {       ListConferenceRecordsRequest request =           ListConferenceRecordsRequest.newBuilder()               .setPageSize(883849137)               .setPageToken("pageToken873572522")               .setFilter("filter-1274492040")               .build();       ApiFuture<ConferenceRecord> future =           conferenceRecordsServiceClient.listConferenceRecordsPagedCallable().futureCall(request);       // Do something.       for (ConferenceRecord element : future.get().iterateAll()) {         // doThingsWith(element);       }     }   } }

Node.js

packages/google-apps-meet/samples/generated/v2/conference_records_service.list_conference_records.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.  */ /**  *  Optional. Maximum number of conference records to return. The service might  *  return fewer than this value. If unspecified, at most 25 conference records  *  are returned. The maximum value is 100; values above 100 are coerced to  *  100. Maximum might change in the future.  */ // const pageSize = 1234 /**  *  Optional. Page token returned from previous List Call.  */ // const pageToken = 'abc123' /**  *  Optional. User specified filtering condition in EBNF  *  format (https://en.wikipedia.org/wiki/Extended_Backus%E2%80%93Naur_form).  *  The following are the filterable fields:  *  * `space.meeting_code`  *  * `space.name`  *  * `start_time`  *  * `end_time`  *  For example, consider the following filters:  *  * `space.name = "spaces/NAME"`  *  * `space.meeting_code = "abc-mnop-xyz"`  *  * `start_time>="2024-01-01T00:00:00.000Z" AND  *  start_time<="2024-01-02T00:00:00.000Z"`  *  * `end_time IS NULL`  */ // const filter = 'abc123'  // Imports the Meet library const {ConferenceRecordsServiceClient} = require('@google-apps/meet').v2;  // Instantiates a client const meetClient = new ConferenceRecordsServiceClient();  async function callListConferenceRecords() {   // Construct request   const request = {   };    // Run request   const iterable = meetClient.listConferenceRecordsAsync(request);   for await (const response of iterable) {       console.log(response);   } }  callListConferenceRecords();

Python

packages/google-apps-meet/samples/generated_samples/meet_v2_generated_conference_records_service_list_conference_records_async.py
# 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_list_conference_records():     # Create a client     client = meet_v2.ConferenceRecordsServiceAsyncClient()      # Initialize request argument(s)     request = meet_v2.ListConferenceRecordsRequest(     )      # Make the request     page_result = client.list_conference_records(request=request)      # Handle the response     async for response in page_result:         print(response)

自定义分页或过滤列表

传递以下可选查询参数可自定义会议记录的分页或过滤:

  • pageSize:要返回的会议记录数上限。服务返回的值可能小于此值。如果未指定,则最多返回 25 条会议记录。最大值为 100;如果值大于 100,系统会自动将其更改为 100。

  • pageToken:从之前的列表调用接收的页面令牌。提供此令牌可检索后续页面。

  • filter:用于在 conferenceRecords 资源结果中检索特定项的查询过滤条件。如需了解支持的查询详情,请参阅 list() 方法。如需详细了解如何确定会议空间,请参阅 Meet 如何识别会议空间