Video API, gRPC: EpisodeService.Update
Updates an existing episode's metadata and settings.
Only fields specified in the field_mask will be updated.
gRPC request
rpc Update (UpdateEpisodeRequest) returns (operation.Operation)
UpdateEpisodeRequest
{
"episode_id": "string",
"field_mask": "google.protobuf.FieldMask",
"title": "string",
"description": "string",
"thumbnail_id": "string",
"start_time": "google.protobuf.Timestamp",
"finish_time": "google.protobuf.Timestamp",
"dvr_seconds": "int64",
"style_preset_id": "string",
// Includes only one of the fields `public_access`, `sign_url_access`
"public_access": "EpisodePublicAccessParams",
"sign_url_access": "EpisodeSignURLAccessParams"
// end of the list of possible fields
}
|
Field |
Description |
|
episode_id |
string Required field. ID of the episode. The maximum string length in characters is 50. |
|
field_mask |
Required field. Field mask specifying which fields of the episode should be updated. |
|
title |
string Episode title. The maximum string length in characters is 300. |
|
description |
string Episode description. The maximum string length in characters is 4000. |
|
thumbnail_id |
string ID of the thumbnail. The maximum string length in characters is 50. |
|
start_time |
Episode start time. |
|
finish_time |
Episode finish time. |
|
dvr_seconds |
int64 Enables episode DVR mode. Possible values:
|
|
style_preset_id |
string New ID of the style preset to be applied to the episode player. The maximum string length in characters is 50. |
|
public_access |
Episode is publicly available. Includes only one of the fields Episode access rights. |
|
sign_url_access |
Access to the episode is restricted by temporarily signed links. Includes only one of the fields Episode access rights. |
EpisodePublicAccessParams
Parameters for episode public access rights.
|
Field |
Description |
|
Empty |
|
EpisodeSignURLAccessParams
Parameters for episode access restrictions based on temporary signed links.
|
Field |
Description |
|
Empty |
|
operation.Operation
{
"id": "string",
"description": "string",
"created_at": "google.protobuf.Timestamp",
"created_by": "string",
"modified_at": "google.protobuf.Timestamp",
"done": "bool",
"metadata": {
"episode_id": "string"
},
// Includes only one of the fields `error`, `response`
"error": "google.rpc.Status",
"response": {
"id": "string",
"stream_id": "string",
"line_id": "string",
"title": "string",
"description": "string",
"thumbnail_id": "string",
"start_time": "google.protobuf.Timestamp",
"finish_time": "google.protobuf.Timestamp",
"dvr_seconds": "int64",
"visibility_status": "VisibilityStatus",
"style_preset_id": "string",
// Includes only one of the fields `public_access`, `sign_url_access`
"public_access": "EpisodePublicAccessRights",
"sign_url_access": "EpisodeSignURLAccessRights",
// end of the list of possible fields
"created_at": "google.protobuf.Timestamp",
"updated_at": "google.protobuf.Timestamp"
}
// end of the list of possible fields
}
An Operation resource. For more information, see Operation.
|
Field |
Description |
|
id |
string ID of the operation. |
|
description |
string Description of the operation. 0-256 characters long. |
|
created_at |
Creation timestamp. |
|
created_by |
string ID of the user or service account who initiated the operation. |
|
modified_at |
The time when the Operation resource was last modified. |
|
done |
bool If the value is |
|
metadata |
Service-specific metadata associated with the operation. |
|
error |
The error result of the operation in case of failure or cancellation. Includes only one of the fields The operation result. |
|
response |
The normal response of the operation in case of success. Includes only one of the fields The operation result. |
UpdateEpisodeMetadata
|
Field |
Description |
|
episode_id |
string ID of the episode being updated. |
Episode
Entity representing a stream fragment that can be accessed independently.
Episodes can be linked to either a stream or a line
and provide a way to reference specific portions of the corresponding content.
|
Field |
Description |
|
id |
string Unique identifier of the episode. |
|
stream_id |
string Identifier of the stream this episode is linked to. |
|
line_id |
string Identifier of the line this episode is linked to. |
|
title |
string Title of the episode displayed in interfaces and players. |
|
description |
string Detailed description of the episode content and context. |
|
thumbnail_id |
string Identifier of the thumbnail image used to represent the episode visually. |
|
start_time |
Timestamp marking the beginning of the episode content. |
|
finish_time |
Timestamp marking the end of the episode content. |
|
dvr_seconds |
int64 Controls the Digital Video Recording (DVR) functionality for the episode. Possible values:
|
|
visibility_status |
enum VisibilityStatus Current visibility status controlling whether the episode is publicly available.
|
|
style_preset_id |
string Identifier of the style preset used in the player during episode playback. |
|
public_access |
Allows unrestricted public access to the episode via direct link. Includes only one of the fields Specifies the episode access permission settings. |
|
sign_url_access |
Restricts episode access using URL signatures for secure time-limited access. Includes only one of the fields Specifies the episode access permission settings. |
|
created_at |
Timestamp when the episode was initially created in the system. |
|
updated_at |
Timestamp of the last modification to the episode or its metadata. |
EpisodePublicAccessRights
Represents public access rights for an episode.
When this access type is set, the episode is publicly accessible via direct link.
|
Field |
Description |
|
Empty |
|
EpisodeSignURLAccessRights
Represents access rights controlled by URL signatures.
When this access type is set, the episode is accessible only via properly signed temporary link.
|
Field |
Description |
|
Empty |
|