Work with conferences

This guide explains how to get details about a single conference or all conferences on the conferenceRecords resource of the Google Meet REST API.

A conference is a server-generated instance of a call within a meeting space. It's also a single instance of a meeting.

If you're a meeting space owner or participant, you can call the get() and list() methods to retrieve conference records.

Authenticating and authorizing with user credentials lets Google Meet apps access user data and perform operations on the authenticated user's behalf. Authenticating with domain-wide delegation lets you authorize an application's service account to access your users' data without requiring each user to give consent.

Get details about a conference

To get details about a specific conference, use the get() method on the conferenceRecords resource with the conference name path parameter. If you don't know the conference name, you can list all conference names using the list() method.

The method returns a past conference as an instance of the conferenceRecords resource.

The following code sample shows how to retrieve a specific conference:

Java

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/getconferencerecord/AsyncGetConferenceRecord.java
importcom.google.api.core.ApiFuture;
importcom.google.apps.meet.v2.ConferenceRecord;
importcom.google.apps.meet.v2.ConferenceRecordName;
importcom.google.apps.meet.v2.ConferenceRecordsServiceClient;
importcom.google.apps.meet.v2.GetConferenceRecordRequest;
publicclass AsyncGetConferenceRecord{
publicstaticvoidmain(String[]args)throwsException{
asyncGetConferenceRecord();
}
publicstaticvoidasyncGetConferenceRecord()throwsException{
// 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(ConferenceRecordsServiceClientconferenceRecordsServiceClient=
ConferenceRecordsServiceClient.create()){
GetConferenceRecordRequestrequest=
GetConferenceRecordRequest.newBuilder()
.setName(ConferenceRecordName.of("[CONFERENCE_RECORD]").toString())
.build();
ApiFuture<ConferenceRecord>future=
conferenceRecordsServiceClient.getConferenceRecordCallable().futureCall(request);
// Do something.
ConferenceRecordresponse=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
constmeetClient=newConferenceRecordsServiceClient();
asyncfunctioncallGetConferenceRecord(){
// Construct request
constrequest={
name,
};
// Run request
constresponse=awaitmeetClient.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
fromgoogle.appsimport meet_v2
async defsample_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)

Replace the conference record name with the name of the specific conference ID in a conference record.

List all conferences

To list details about all conferences, use the list() method on the conferenceRecords resource without any path parameters.

The method returns a list of past conferences as an instance of the conferenceRecords resource. They're filtered to the conference organizer and ordered by startTime in descending order. To adjust the page size and filter the query results, see Customize pagination or filter the list.

The following code sample shows how to list all conferences:

Java

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/listconferencerecords/AsyncListConferenceRecords.java
importcom.google.api.core.ApiFuture;
importcom.google.apps.meet.v2.ConferenceRecord;
importcom.google.apps.meet.v2.ConferenceRecordsServiceClient;
importcom.google.apps.meet.v2.ListConferenceRecordsRequest;
publicclass AsyncListConferenceRecords{
publicstaticvoidmain(String[]args)throwsException{
asyncListConferenceRecords();
}
publicstaticvoidasyncListConferenceRecords()throwsException{
// 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(ConferenceRecordsServiceClientconferenceRecordsServiceClient=
ConferenceRecordsServiceClient.create()){
ListConferenceRecordsRequestrequest=
ListConferenceRecordsRequest.newBuilder()
.setPageSize(883849137)
.setPageToken("pageToken873572522")
.setFilter("filter-1274492040")
.build();
ApiFuture<ConferenceRecord>future=
conferenceRecordsServiceClient.listConferenceRecordsPagedCallable().futureCall(request);
// Do something.
for(ConferenceRecordelement: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
constmeetClient=newConferenceRecordsServiceClient();
asyncfunctioncallListConferenceRecords(){
// Construct request
constrequest={
};
// Run request
constiterable=meetClient.listConferenceRecordsAsync(request);
forawait(constresponseofiterable){
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
fromgoogle.appsimport meet_v2
async defsample_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)

Customize pagination or filter the list

Pass the following optional query parameters to customize pagination of, or filter, conference records:

  • pageSize: The 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 more than 100 are automatically changed to 100.

  • pageToken: A page token, received from a previous list call. Provide this token to retrieve the subsequent page.

  • filter: A query filter to retrieve specific items in the conferenceRecords resource results. For supported query details, see the list() method. For more information on how to determine a meeting space, see How Meet identifies a meeting space.

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025年10月13日 UTC.