REST Resource: conferenceRecords.recordings
Stay organized with collections
Save and categorize content based on your preferences.
Resource: Recording
Metadata about a recording created during a conference.
| JSON representation |
{
"name": string,
"state": enum (State),
"startTime": string,
"endTime": string,
// Union field destination can be only one of the following:
"driveDestination": {
object (DriveDestination)
}
// End of list of possible types for union field destination.
} |
| Fields |
name |
string
Output only. Resource name of the recording. Format: conferenceRecords/{conferenceRecord}/recordings/{recording} where {recording} is a 1:1 mapping to each unique recording session during the conference.
|
state |
enum (State)
Output only. Current state.
|
startTime |
string (Timestamp format)
Output only. Timestamp when the recording started.
|
endTime |
string (Timestamp format)
Output only. Timestamp when the recording ended.
|
Union field destination. destination can be only one of the following:
|
driveDestination |
object (DriveDestination)
Output only. Recording is saved to Google Drive as an MP4 file. The driveDestination includes the Drive fileId that can be used to download the file using the files.get method of the Drive API.
|
DriveDestination
Export location where a recording file is saved in Google Drive.
| JSON representation |
{
"file": string,
"exportUri": string
} |
| Fields |
file |
string
Output only. The fileId for the underlying MP4 file. For example, "1kuceFZohVoCh6FulBHxwy6I15Ogpc4hP". Use $ GET
https://www.googleapis.com/drive/v3/files/{$fileId}?alt=media to download the blob. For more information, see https://developers.google.com/drive/api/v3/reference/files/get.
|
exportUri |
string
Output only. Link used to play back the recording file in the browser. For example, https://drive.google.com/file/d/{$fileId}/view.
|
State
Current state of the recording session.
| Enums |
STATE_UNSPECIFIED |
Default, never used. |
STARTED |
An active recording session has started. |
ENDED |
This recording session has ended, but the recording file hasn't been generated yet. |
FILE_GENERATED |
Recording file is generated and ready to download. |
Methods |
|
|
Gets a recording by recording ID. |
|
|
Lists the recording resources from the conference record. |
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-04-02 UTC.
[null,null,["Last updated 2025-04-02 UTC."],[],[],null,["# REST Resource: conferenceRecords.recordings\n\n- [Resource: Recording](#Recording)\n - [JSON representation](#Recording.SCHEMA_REPRESENTATION)\n- [DriveDestination](#DriveDestination)\n - [JSON representation](#DriveDestination.SCHEMA_REPRESENTATION)\n- [State](#State)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Recording\n-------------------\n\nMetadata about a recording created during a conference.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"state\": enum (/workspace/meet/api/reference/rest/v2/conferenceRecords.recordings#State), \"startTime\": string, \"endTime\": string, // Union field `destination` can be only one of the following: \"driveDestination\": { object (/workspace/meet/api/reference/rest/v2/conferenceRecords.recordings#DriveDestination) } // End of list of possible types for union field `destination`. } ``` |\n\n| Fields ||\n|--------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Output only. Resource name of the recording. Format: `conferenceRecords/{conferenceRecord}/recordings/{recording}` where `{recording}` is a 1:1 mapping to each unique recording session during the conference. |\n| `state` | `enum (`[State](/workspace/meet/api/reference/rest/v2/conferenceRecords.recordings#State)`)` Output only. Current state. |\n| `startTime` | `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` Output only. Timestamp when the recording started. |\n| `endTime` | `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` Output only. Timestamp when the recording ended. |\n| Union field `destination`. `destination` can be only one of the following: ||\n| `driveDestination` | `object (`[DriveDestination](/workspace/meet/api/reference/rest/v2/conferenceRecords.recordings#DriveDestination)`)` Output only. Recording is saved to Google Drive as an MP4 file. The `driveDestination` includes the Drive `fileId` that can be used to download the file using the `files.get` method of the Drive API. |\n\nDriveDestination\n----------------\n\nExport location where a recording file is saved in Google Drive.\n\n| JSON representation |\n|-------------------------------------------------|\n| ``` { \"file\": string, \"exportUri\": string } ``` |\n\n| Fields ||\n|-------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `file` | `string` Output only. The `fileId` for the underlying MP4 file. For example, \"1kuceFZohVoCh6FulBHxwy6I15Ogpc4hP\". Use `$ GET https://www.googleapis.com/drive/v3/files/{$fileId}?alt=media` to download the blob. For more information, see \u003chttps://developers.google.com/drive/api/v3/reference/files/get\u003e. |\n| `exportUri` | `string` Output only. Link used to play back the recording file in the browser. For example, `https://drive.google.com/file/d/{$fileId}/view`. |\n\nState\n-----\n\nCurrent state of the recording session.\n\n| Enums ||\n|---------------------|-------------------------------------------------------------------------------------|\n| `STATE_UNSPECIFIED` | Default, never used. |\n| `STARTED` | An active recording session has started. |\n| `ENDED` | This recording session has ended, but the recording file hasn't been generated yet. |\n| `FILE_GENERATED` | Recording file is generated and ready to download. |\n\n| Methods ------- ||\n|-------------------------------------------------------------------------------------|-----------------------------------------------------------|\n| ### [get](/workspace/meet/api/reference/rest/v2/conferenceRecords.recordings/get) | Gets a recording by recording ID. |\n| ### [list](/workspace/meet/api/reference/rest/v2/conferenceRecords.recordings/list) | Lists the recording resources from the conference record. |"]]
