Work with artifacts

    This guide explains how to get details about the different meeting artifacts generated by a conference using the Google Meet REST API.

    An artifact is a file or data generated by Google Meet in response to a conference . This includes videos and other artifacts, such as transcripts.

    To produce artifacts, participants must generate them in Meet before the conference ends. Transcripts operate independently of recordings and you don't have to record the meeting to generate a transcript. For more information, see Record a video meeting and Use Transcripts with Google Meet .

    If you're a meeting space owner or participant, you can call the get() and list() methods on the recordings , transcripts , and the transcripts.entries resources to retrieve artifacts.

    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.

    Artifact retention

    After a conference ends, Meet saves recordings and transcripts to the meeting organizer's Google Drive. By default, Meet artifacts are retained according to Drive rules.

    Transcript entries provided by the Meet REST API are deleted 30 days after the conference ends.

    You also can manage the retention of Meet artifacts separately using Meet-specific retention rules in Google Vault. For more information, see Retain Google Meet data with Vault .

    Recordings

    The following sections detail how to get information about recordings in a conference record.

    Meet has access to the recording ID after the recording file is generated. It's possible a user might delete the recording file from Google Drive, yet the unique name is still returned in Meet.

    The recordings resource includes both the DriveDestination and the State objects.

    The DriveDestination object holds the export location in Drive where the recording is saved as an MP4 file. To download the recording or to play it back in a browser, use the object's exportUri field value. If you're familiar with the Google Drive API, the file field value corresponds to the id in the files resource. For more information, see Download and export files .

    The State object holds the status of the recording session. This lets you query if the recording has started, if the recording has ended but the recording file isn't ready, or if the recording file is generated and ready to download.

    Get details about a recording

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

    The method returns an instance of a recordings resource.

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

    Java

    java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/getrecording/AsyncGetRecording.java
     import 
  
 com.google.api.core.ApiFuture 
 ; 
 import 
  
 com.google.apps.meet.v2.ConferenceRecordsServiceClient 
 ; 
 import 
  
 com.google.apps.meet.v2.GetRecordingRequest 
 ; 
 import 
  
 com.google.apps.meet.v2.Recording 
 ; 
 import 
  
 com.google.apps.meet.v2.RecordingName 
 ; 
 public 
  
 class 
 AsyncGetRecording 
  
 { 
  
 public 
  
 static 
  
 void 
  
 main 
 ( 
 String 
 [] 
  
 args 
 ) 
  
 throws 
  
 Exception 
  
 { 
  
 asyncGetRecording 
 (); 
  
 } 
  
 public 
  
 static 
  
 void 
  
 asyncGetRecording 
 () 
  
 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 
 ()) 
  
 { 
  
 GetRecordingRequest 
  
 request 
  
 = 
  
 GetRecordingRequest 
 . 
 newBuilder 
 () 
  
 . 
 setName 
 ( 
 RecordingName 
 . 
 of 
 ( 
 "[CONFERENCE_RECORD]" 
 , 
  
 "[RECORDING]" 
 ). 
 toString 
 ()) 
  
 . 
 build 
 (); 
  
 ApiFuture<Recording> 
  
 future 
  
 = 
  
 conferenceRecordsServiceClient 
 . 
 getRecordingCallable 
 (). 
 futureCall 
 ( 
 request 
 ); 
  
 // Do something. 
  
 Recording 
  
 response 
  
 = 
  
 future 
 . 
 get 
 (); 
  
 } 
  
 } 
 }

    Node.js

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

    Python

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

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

    List all recordings

    To list details about all recordings in a conference record, use the list() method on the recordings resource with the parent path parameter. Format: conferenceRecords/{conferenceRecord} .

    The method returns a list of conference recordings, ordered by startTime in ascending order, as an instance of a recordings resource. To adjust the page size, see Customize pagination .

    The following code sample shows how to list all recordings in a conference record:

    Java

    java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/listrecordings/AsyncListRecordings.java
     import 
  
 com.google.api.core.ApiFuture 
 ; 
 import 
  
 com.google.apps.meet.v2.ConferenceRecordName 
 ; 
 import 
  
 com.google.apps.meet.v2.ConferenceRecordsServiceClient 
 ; 
 import 
  
 com.google.apps.meet.v2.ListRecordingsRequest 
 ; 
 import 
  
 com.google.apps.meet.v2.Recording 
 ; 
 public 
  
 class 
 AsyncListRecordings 
  
 { 
  
 public 
  
 static 
  
 void 
  
 main 
 ( 
 String 
 [] 
  
 args 
 ) 
  
 throws 
  
 Exception 
  
 { 
  
 asyncListRecordings 
 (); 
  
 } 
  
 public 
  
 static 
  
 void 
  
 asyncListRecordings 
 () 
  
 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 
 ()) 
  
 { 
  
 ListRecordingsRequest 
  
 request 
  
 = 
  
 ListRecordingsRequest 
 . 
 newBuilder 
 () 
  
 . 
 setParent 
 ( 
 ConferenceRecordName 
 . 
 of 
 ( 
 "[CONFERENCE_RECORD]" 
 ). 
 toString 
 ()) 
  
 . 
 setPageSize 
 ( 
 883849137 
 ) 
  
 . 
 setPageToken 
 ( 
 "pageToken873572522" 
 ) 
  
 . 
 build 
 (); 
  
 ApiFuture<Recording> 
  
 future 
  
 = 
  
 conferenceRecordsServiceClient 
 . 
 listRecordingsPagedCallable 
 (). 
 futureCall 
 ( 
 request 
 ); 
  
 // Do something. 
  
 for 
  
 ( 
 Recording 
  
 element 
  
 : 
  
 future 
 . 
 get 
 (). 
 iterateAll 
 ()) 
  
 { 
  
 // doThingsWith(element); 
  
 } 
  
 } 
  
 } 
 }

    Node.js

    packages/google-apps-meet/samples/generated/v2/conference_records_service.list_recordings.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. Format: `conferenceRecords/{conference_record}` 
 */ 
 // const parent = 'abc123' 
 /** 
 *  Maximum number of recordings to return. The service might return fewer 
 *  than this value. 
 *  If unspecified, at most 10 recordings are returned. 
 *  The maximum value is 100; values above 100 are coerced to 100. 
 *  Maximum might change in the future. 
 */ 
 // const pageSize = 1234 
 /** 
 *  Page token returned from previous List Call. 
 */ 
 // const pageToken = 'abc123' 
 // Imports the Meet library 
 const 
  
 { 
 ConferenceRecordsServiceClient 
 } 
  
 = 
  
 require 
 ( 
 '@google-apps/meet' 
 ). 
 v2 
 ; 
 // Instantiates a client 
 const 
  
 meetClient 
  
 = 
  
 new 
  
 ConferenceRecordsServiceClient 
 (); 
 async 
  
 function 
  
 callListRecordings 
 () 
  
 { 
  
 // Construct request 
  
 const 
  
 request 
  
 = 
  
 { 
  
 parent 
 , 
  
 }; 
  
 // Run request 
  
 const 
  
 iterable 
  
 = 
  
 meetClient 
 . 
 listRecordingsAsync 
 ( 
 request 
 ); 
  
 for 
  
 await 
  
 ( 
 const 
  
 response 
  
 of 
  
 iterable 
 ) 
  
 { 
  
 console 
 . 
 log 
 ( 
 response 
 ); 
  
 } 
 } 
 callListRecordings 
 ();

    Python

    packages/google-apps-meet/samples/generated_samples/meet_v2_generated_conference_records_service_list_recordings_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_recordings 
 (): 
 # Create a client 
 client 
 = 
 meet_v2 
 . 
 ConferenceRecordsServiceAsyncClient 
 () 
 # Initialize request argument(s) 
 request 
 = 
 meet_v2 
 . 
 ListRecordingsRequest 
 ( 
 parent 
 = 
 "parent_value" 
 , 
 ) 
 # Make the request 
 page_result 
 = 
 client 
 . 
 list_recordings 
 ( 
 request 
 = 
 request 
 ) 
 # Handle the response 
 async 
 for 
 response 
 in 
 page_result 
 : 
 print 
 ( 
 response 
 )

    Replace the parent value with the name of the conference record.

    Transcripts

    The following sections detail how to get information about conference transcripts in a conference record.

    Meet has access to the transcript ID once the transcript data is generated. It's possible a user might delete the transcript file from Drive, yet the unique name is still returned in Meet.

    The transcripts resource includes both the DocsDestination and the State objects.

    The DocsDestination object holds the export location in Drive where the Google Docs transcript file is saved. To fetch the content or to browse the transcript in a browser, use the object's exportUri field value. If you're familiar with the Google Docs API, the document field value corresponds to the documentId in the documents resource.

    The State object holds the status of the transcript session. This lets you query if the transcript session has started, if the transcript session has ended but the transcript file isn't ready, or if the transcript file is generated and ready to download.

    Get details about a transcript

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

    The method returns an instance of a transcripts resource.

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

    Java

    java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/gettranscript/AsyncGetTranscript.java
     import 
  
 com.google.api.core.ApiFuture 
 ; 
 import 
  
 com.google.apps.meet.v2.ConferenceRecordsServiceClient 
 ; 
 import 
  
 com.google.apps.meet.v2.GetTranscriptRequest 
 ; 
 import 
  
 com.google.apps.meet.v2.Transcript 
 ; 
 import 
  
 com.google.apps.meet.v2.TranscriptName 
 ; 
 public 
  
 class 
 AsyncGetTranscript 
  
 { 
  
 public 
  
 static 
  
 void 
  
 main 
 ( 
 String 
 [] 
  
 args 
 ) 
  
 throws 
  
 Exception 
  
 { 
  
 asyncGetTranscript 
 (); 
  
 } 
  
 public 
  
 static 
  
 void 
  
 asyncGetTranscript 
 () 
  
 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 
 ()) 
  
 { 
  
 GetTranscriptRequest 
  
 request 
  
 = 
  
 GetTranscriptRequest 
 . 
 newBuilder 
 () 
  
 . 
 setName 
 ( 
 TranscriptName 
 . 
 of 
 ( 
 "[CONFERENCE_RECORD]" 
 , 
  
 "[TRANSCRIPT]" 
 ). 
 toString 
 ()) 
  
 . 
 build 
 (); 
  
 ApiFuture<Transcript> 
  
 future 
  
 = 
  
 conferenceRecordsServiceClient 
 . 
 getTranscriptCallable 
 (). 
 futureCall 
 ( 
 request 
 ); 
  
 // Do something. 
  
 Transcript 
  
 response 
  
 = 
  
 future 
 . 
 get 
 (); 
  
 } 
  
 } 
 }

    Node.js

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

    Python

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

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

    List all transcripts

    To list details about all transcripts in a conference record, use the list() method on the transcripts resource with the parent path parameter. Format: conferenceRecords/{conferenceRecord} .

    The method returns a list of conference transcripts, ordered by startTime in ascending order, as an instance of a transcripts resource. To adjust the page size, see Customize pagination .

    The following code sample shows how to list all transcripts in a conference record:

    Java

    java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/listtranscripts/AsyncListTranscripts.java
     import 
  
 com.google.api.core.ApiFuture 
 ; 
 import 
  
 com.google.apps.meet.v2.ConferenceRecordName 
 ; 
 import 
  
 com.google.apps.meet.v2.ConferenceRecordsServiceClient 
 ; 
 import 
  
 com.google.apps.meet.v2.ListTranscriptsRequest 
 ; 
 import 
  
 com.google.apps.meet.v2.Transcript 
 ; 
 public 
  
 class 
 AsyncListTranscripts 
  
 { 
  
 public 
  
 static 
  
 void 
  
 main 
 ( 
 String 
 [] 
  
 args 
 ) 
  
 throws 
  
 Exception 
  
 { 
  
 asyncListTranscripts 
 (); 
  
 } 
  
 public 
  
 static 
  
 void 
  
 asyncListTranscripts 
 () 
  
 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 
 ()) 
  
 { 
  
 ListTranscriptsRequest 
  
 request 
  
 = 
  
 ListTranscriptsRequest 
 . 
 newBuilder 
 () 
  
 . 
 setParent 
 ( 
 ConferenceRecordName 
 . 
 of 
 ( 
 "[CONFERENCE_RECORD]" 
 ). 
 toString 
 ()) 
  
 . 
 setPageSize 
 ( 
 883849137 
 ) 
  
 . 
 setPageToken 
 ( 
 "pageToken873572522" 
 ) 
  
 . 
 build 
 (); 
  
 ApiFuture<Transcript> 
  
 future 
  
 = 
  
 conferenceRecordsServiceClient 
 . 
 listTranscriptsPagedCallable 
 (). 
 futureCall 
 ( 
 request 
 ); 
  
 // Do something. 
  
 for 
  
 ( 
 Transcript 
  
 element 
  
 : 
  
 future 
 . 
 get 
 (). 
 iterateAll 
 ()) 
  
 { 
  
 // doThingsWith(element); 
  
 } 
  
 } 
  
 } 
 }

    Node.js

    packages/google-apps-meet/samples/generated/v2/conference_records_service.list_transcripts.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. Format: `conferenceRecords/{conference_record}` 
 */ 
 // const parent = 'abc123' 
 /** 
 *  Maximum number of transcripts to return. The service might return fewer 
 *  than this value. 
 *  If unspecified, at most 10 transcripts are returned. 
 *  The maximum value is 100; values above 100 are coerced to 100. 
 *  Maximum might change in the future. 
 */ 
 // const pageSize = 1234 
 /** 
 *  Page token returned from previous List Call. 
 */ 
 // const pageToken = 'abc123' 
 // Imports the Meet library 
 const 
  
 { 
 ConferenceRecordsServiceClient 
 } 
  
 = 
  
 require 
 ( 
 '@google-apps/meet' 
 ). 
 v2 
 ; 
 // Instantiates a client 
 const 
  
 meetClient 
  
 = 
  
 new 
  
 ConferenceRecordsServiceClient 
 (); 
 async 
  
 function 
  
 callListTranscripts 
 () 
  
 { 
  
 // Construct request 
  
 const 
  
 request 
  
 = 
  
 { 
  
 parent 
 , 
  
 }; 
  
 // Run request 
  
 const 
  
 iterable 
  
 = 
  
 meetClient 
 . 
 listTranscriptsAsync 
 ( 
 request 
 ); 
  
 for 
  
 await 
  
 ( 
 const 
  
 response 
  
 of 
  
 iterable 
 ) 
  
 { 
  
 console 
 . 
 log 
 ( 
 response 
 ); 
  
 } 
 } 
 callListTranscripts 
 ();

    Python

    packages/google-apps-meet/samples/generated_samples/meet_v2_generated_conference_records_service_list_transcripts_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_transcripts 
 (): 
 # Create a client 
 client 
 = 
 meet_v2 
 . 
 ConferenceRecordsServiceAsyncClient 
 () 
 # Initialize request argument(s) 
 request 
 = 
 meet_v2 
 . 
 ListTranscriptsRequest 
 ( 
 parent 
 = 
 "parent_value" 
 , 
 ) 
 # Make the request 
 page_result 
 = 
 client 
 . 
 list_transcripts 
 ( 
 request 
 = 
 request 
 ) 
 # Handle the response 
 async 
 for 
 response 
 in 
 page_result 
 : 
 print 
 ( 
 response 
 )

    Replace the parent value with the name of the conference record.

    Transcript entries

    The following sections detail how to get each participant's speech as transcript entries during a conference transcript session.

    The transcript entry contains transcribed text of the participant's voice, up to a maximum of 10,000 words. The spoken text languageCode (for example, en-US ) is also included as IETF BCP 47 syntax .

    Each transcript entry is connected to a participant name in the conference. To retrieve participant details, see Get details about a participant .

    Transcript entry data is available for 30 days after the conference ends.

    Note that the transcript entries returned by the Meet REST API might not match the transcription found in the Docs transcript file. This occurs when the transcript file is modified after generation.

    Get details about a transcript entry

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

    The method returns an instance of a transcripts.entries resource.

    The following code sample shows how to retrieve a specific transcript entry:

    Java

    java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/gettranscriptentry/AsyncGetTranscriptEntry.java
     import 
  
 com.google.api.core.ApiFuture 
 ; 
 import 
  
 com.google.apps.meet.v2.ConferenceRecordsServiceClient 
 ; 
 import 
  
 com.google.apps.meet.v2.GetTranscriptEntryRequest 
 ; 
 import 
  
 com.google.apps.meet.v2.TranscriptEntry 
 ; 
 import 
  
 com.google.apps.meet.v2.TranscriptEntryName 
 ; 
 public 
  
 class 
 AsyncGetTranscriptEntry 
  
 { 
  
 public 
  
 static 
  
 void 
  
 main 
 ( 
 String 
 [] 
  
 args 
 ) 
  
 throws 
  
 Exception 
  
 { 
  
 asyncGetTranscriptEntry 
 (); 
  
 } 
  
 public 
  
 static 
  
 void 
  
 asyncGetTranscriptEntry 
 () 
  
 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 
 ()) 
  
 { 
  
 GetTranscriptEntryRequest 
  
 request 
  
 = 
  
 GetTranscriptEntryRequest 
 . 
 newBuilder 
 () 
  
 . 
 setName 
 ( 
  
 TranscriptEntryName 
 . 
 of 
 ( 
 "[CONFERENCE_RECORD]" 
 , 
  
 "[TRANSCRIPT]" 
 , 
  
 "[ENTRY]" 
 ) 
  
 . 
 toString 
 ()) 
  
 . 
 build 
 (); 
  
 ApiFuture<TranscriptEntry> 
  
 future 
  
 = 
  
 conferenceRecordsServiceClient 
 . 
 getTranscriptEntryCallable 
 (). 
 futureCall 
 ( 
 request 
 ); 
  
 // Do something. 
  
 TranscriptEntry 
  
 response 
  
 = 
  
 future 
 . 
 get 
 (); 
  
 } 
  
 } 
 }

    Node.js

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

    Python

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

    Replace the transcript entry name with the name of the specific transcript entry ID in a transcript.

    List all transcript entries

    To list details about all transcript entries in a transcript, use the list() method on the transcripts.entries resource with the parent path parameter. Format: conferenceRecords/{conferenceRecord}/transcripts/{transcript} .

    The method returns a list of structured transcript entries per conference transcript, ordered by startTime in ascending order, as an instance of a transcripts.entries resource. To adjust the page size, see Customize pagination .

    The following code sample shows how to list all transcript entries in a transcript:

    Java

    java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/listtranscriptentries/AsyncListTranscriptEntries.java
     import 
  
 com.google.api.core.ApiFuture 
 ; 
 import 
  
 com.google.apps.meet.v2.ConferenceRecordsServiceClient 
 ; 
 import 
  
 com.google.apps.meet.v2.ListTranscriptEntriesRequest 
 ; 
 import 
  
 com.google.apps.meet.v2.TranscriptEntry 
 ; 
 import 
  
 com.google.apps.meet.v2.TranscriptName 
 ; 
 public 
  
 class 
 AsyncListTranscriptEntries 
  
 { 
  
 public 
  
 static 
  
 void 
  
 main 
 ( 
 String 
 [] 
  
 args 
 ) 
  
 throws 
  
 Exception 
  
 { 
  
 asyncListTranscriptEntries 
 (); 
  
 } 
  
 public 
  
 static 
  
 void 
  
 asyncListTranscriptEntries 
 () 
  
 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 
 ()) 
  
 { 
  
 ListTranscriptEntriesRequest 
  
 request 
  
 = 
  
 ListTranscriptEntriesRequest 
 . 
 newBuilder 
 () 
  
 . 
 setParent 
 ( 
 TranscriptName 
 . 
 of 
 ( 
 "[CONFERENCE_RECORD]" 
 , 
  
 "[TRANSCRIPT]" 
 ). 
 toString 
 ()) 
  
 . 
 setPageSize 
 ( 
 883849137 
 ) 
  
 . 
 setPageToken 
 ( 
 "pageToken873572522" 
 ) 
  
 . 
 build 
 (); 
  
 ApiFuture<TranscriptEntry> 
  
 future 
  
 = 
  
 conferenceRecordsServiceClient 
 . 
 listTranscriptEntriesPagedCallable 
 (). 
 futureCall 
 ( 
 request 
 ); 
  
 // Do something. 
  
 for 
  
 ( 
 TranscriptEntry 
  
 element 
  
 : 
  
 future 
 . 
 get 
 (). 
 iterateAll 
 ()) 
  
 { 
  
 // doThingsWith(element); 
  
 } 
  
 } 
  
 } 
 }

    Node.js

    packages/google-apps-meet/samples/generated/v2/conference_records_service.list_transcript_entries.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. Format: 
 *  `conferenceRecords/{conference_record}/transcripts/{transcript}` 
 */ 
 // const parent = 'abc123' 
 /** 
 *  Maximum number of entries to return. The service might return fewer than 
 *  this value. 
 *  If unspecified, at most 10 entries are returned. 
 *  The maximum value is 100; values above 100 are coerced to 100. 
 *  Maximum might change in the future. 
 */ 
 // const pageSize = 1234 
 /** 
 *  Page token returned from previous List Call. 
 */ 
 // const pageToken = 'abc123' 
 // Imports the Meet library 
 const 
  
 { 
 ConferenceRecordsServiceClient 
 } 
  
 = 
  
 require 
 ( 
 '@google-apps/meet' 
 ). 
 v2 
 ; 
 // Instantiates a client 
 const 
  
 meetClient 
  
 = 
  
 new 
  
 ConferenceRecordsServiceClient 
 (); 
 async 
  
 function 
  
 callListTranscriptEntries 
 () 
  
 { 
  
 // Construct request 
  
 const 
  
 request 
  
 = 
  
 { 
  
 parent 
 , 
  
 }; 
  
 // Run request 
  
 const 
  
 iterable 
  
 = 
  
 meetClient 
 . 
 listTranscriptEntriesAsync 
 ( 
 request 
 ); 
  
 for 
  
 await 
  
 ( 
 const 
  
 response 
  
 of 
  
 iterable 
 ) 
  
 { 
  
 console 
 . 
 log 
 ( 
 response 
 ); 
  
 } 
 } 
 callListTranscriptEntries 
 ();

    Python

    packages/google-apps-meet/samples/generated_samples/meet_v2_generated_conference_records_service_list_transcript_entries_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_transcript_entries 
 (): 
 # Create a client 
 client 
 = 
 meet_v2 
 . 
 ConferenceRecordsServiceAsyncClient 
 () 
 # Initialize request argument(s) 
 request 
 = 
 meet_v2 
 . 
 ListTranscriptEntriesRequest 
 ( 
 parent 
 = 
 "parent_value" 
 , 
 ) 
 # Make the request 
 page_result 
 = 
 client 
 . 
 list_transcript_entries 
 ( 
 request 
 = 
 request 
 ) 
 # Handle the response 
 async 
 for 
 response 
 in 
 page_result 
 : 
 print 
 ( 
 response 
 )

    Replace the parent value with the name of the conference record and the transcript name.

    Customize pagination

    Pass the following query parameters to customize pagination of recordings, transcripts, and transcript entries:

    • pageSize : The maximum number of items to return. The service might return fewer than this value. If unspecified, at most 10 items 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.
    Create a Mobile Website
    View Site in Mobile | Classic
    Share by: