Video API, gRPC: VideoService.Create

Статья создана

Обновлена 25 ноября 2025 г.

gRPC request
CreateVideoRequest
VideoTUSDParams
VideoPublicAccessParams
VideoSignURLAccessParams
operation.Operation
CreateVideoMetadata
Video
VideoFeatures
Summary
SummaryURL
VideoTUSDSource
VideoPublicAccessRights
VideoSignURLAccessRights

Creates a new video in the specified channel.
The video can be created from different sources: TUS upload, direct link, or S3 storage.

gRPC request

rpc Create (CreateVideoRequest) returns (operation.Operation)

CreateVideoRequest

{
  "channel_id": "string",
  "title": "string",
  "description": "string",
  "thumbnail_id": "string",
  "auto_transcode": "AutoTranscode",
  "style_preset_id": "string",
  "auto_publish": "google.protobuf.BoolValue",
  "enable_ad": "google.protobuf.BoolValue",
  "labels": "map<string, string>",
  // Includes only one of the fields `tusd`
  "tusd": {
    "file_size": "int64",
    "file_name": "string"
  },
  // end of the list of possible fields
  // Includes only one of the fields `public_access`, `sign_url_access`
  "public_access": "VideoPublicAccessParams",
  "sign_url_access": "VideoSignURLAccessParams"
  // end of the list of possible fields
}

Field	Description
channel_id	string Required field. ID of the channel where the video will be created. The maximum string length in characters is 50.
title	string Required field. Title of the video to be displayed in interfaces and players. The maximum string length in characters is 300.
description	string Detailed description of the video content and context. Optional field that can provide additional information about the video. The maximum string length in characters is 4000.
thumbnail_id	string ID of the thumbnail image to be used for the video. If not provided, a thumbnail may be automatically generated during transcoding. The maximum string length in characters is 50.
auto_transcode	enum AutoTranscode Controls whether transcoding starts automatically after upload. Set to ENABLE to automatically initiate transcoding after upload, or DISABLE for manual initiation via the Transcode() method. `AUTO_TRANSCODE_UNSPECIFIED`: The auto-transcoding setting is not specified. `ENABLE`: Automatically start transcoding after the video upload is complete. `DISABLE`: Do not automatically transcode; requires manual initiation via the Transcode() method.
style_preset_id	string ID of the style preset to apply to the video during processing. Style presets define visual appearance settings for the video player. The maximum string length in characters is 50.
auto_publish	google.protobuf.BoolValue Controls whether the video is automatically published after transcoding. When set to true, the video's visibility status will be set to PUBLISHED once transcoding is complete, making it available for watching.
enable_ad	google.protobuf.BoolValue Controls the ability to display advertisements for this video. Default: true Set explicitly to false to disable advertisements for this specific video.
labels	object (map<string, string>) Custom user-defined labels as `key:value` pairs. Maximum 64 labels per video. Keys must be lowercase alphanumeric strings with optional hyphens/underscores. Values can contain alphanumeric characters and various symbols. No more than 64 per resource. The maximum string length in characters for each value is 63. Each value must match the regular expression `[-_.@:/0-9a-zA-Z]`. The maximum string length in characters for each key is 63. Each key must match the regular expression `[a-z][-_0-9a-z]`.
tusd	VideoTUSDParams Upload video using the TUS (Tus Resumable Upload Protocol) protocol. This is a push-based upload method where the client pushes data to the server. Includes only one of the fields `tusd`. Specifies the video upload source method (exactly one must be chosen).
public_access	VideoPublicAccessParams Video is publicly available. Includes only one of the fields `public_access`, `sign_url_access`. Video access permission settings (exactly one must be chosen).
sign_url_access	VideoSignURLAccessParams Access to the video is restricted by temporarily signed links. Includes only one of the fields `public_access`, `sign_url_access`. Video access permission settings (exactly one must be chosen).

VideoTUSDParams

Field

Description

file_size

int64

Total size of the file to be uploaded, in bytes.

Value must be greater than 0.

file_name

string

Original name of the file being uploaded.
This is used for reference and does not affect the upload process.

VideoPublicAccessParams

Parameters for video public access rights.

Field	Description
Empty

VideoSignURLAccessParams

Parameters for video 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": {
    "video_id": "string"
  },
  // Includes only one of the fields `error`, `response`
  "error": "google.rpc.Status",
  "response": {
    "id": "string",
    "channel_id": "string",
    "title": "string",
    "description": "string",
    "thumbnail_id": "string",
    "status": "VideoStatus",
    "error_message": "string",
    "visibility_status": "VisibilityStatus",
    "duration": "google.protobuf.Duration",
    "auto_transcode": "AutoTranscode",
    "style_preset_id": "string",
    "enable_ad": "google.protobuf.BoolValue",
    "subtitle_ids": [
      "string"
    ],
    "features": {
      "summary": {
        "result": "FeatureResult",
        "urls": [
          {
            "url": "string",
            "track_index": "int64",
            "src_lang": "string"
          }
        ]
      }
    },
    // Includes only one of the fields `tusd`
    "tusd": {
      "url": "string",
      "file_size": "int64"
    },
    // end of the list of possible fields
    // Includes only one of the fields `public_access`, `sign_url_access`
    "public_access": "VideoPublicAccessRights",
    "sign_url_access": "VideoSignURLAccessRights",
    // end of the list of possible fields
    "created_at": "google.protobuf.Timestamp",
    "updated_at": "google.protobuf.Timestamp",
    "labels": "map<string, string>"
  }
  // 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	google.protobuf.Timestamp Creation timestamp.
created_by	string ID of the user or service account who initiated the operation.
modified_at	google.protobuf.Timestamp The time when the Operation resource was last modified.
done	bool If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.
metadata	CreateVideoMetadata Service-specific metadata associated with the operation. It typically contains the ID of the target resource that the operation is performed on. Any method that returns a long-running operation should document the metadata type, if any.
error	google.rpc.Status The error result of the operation in case of failure or cancellation. Includes only one of the fields `error`, `response`. The operation result. If `done == false` and there was no failure detected, neither `error` nor `response` is set. If `done == false` and there was a failure detected, `error` is set. If `done == true`, exactly one of `error` or `response` is set.
response	Video The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is the standard Create/Update, the response should be the target resource of the operation. Any method that returns a long-running operation should document the response type, if any. Includes only one of the fields `error`, `response`. The operation result. If `done == false` and there was no failure detected, neither `error` nor `response` is set. If `done == false` and there was a failure detected, `error` is set. If `done == true`, exactly one of `error` or `response` is set.

CreateVideoMetadata

Field

Description

video_id

string

Unique identifier of the video.

Video

Main entity representing a video in the platform.

Field	Description
id	string Unique identifier of the video.
channel_id	string Identifier of the channel where the video is created and managed.
title	string Title of the video displayed to users in interfaces and players.
description	string Detailed description of the video content and context.
thumbnail_id	string Identifier of the thumbnail image used to represent the video visually.
status	enum VideoStatus Current processing status of the video. `VIDEO_STATUS_UNSPECIFIED`: The video status is not specified. `WAIT_UPLOADING`: The video upload is in progress, waiting for all bytes to be received. `UPLOADED`: The video has been fully uploaded and is ready for transcoding. `PROCESSING`: The video is currently being processed. `READY`: The video has been successfully processed and is ready for watching. `ERROR`: An error occurred during video processing.
error_message	string Error message describing the reason for video processing failure, if any.
visibility_status	enum VisibilityStatus Current visibility status controlling whether the video is publicly available. `VISIBILITY_STATUS_UNSPECIFIED`: The visibility status is not specified. `PUBLISHED`: The video is publicly available, subject to its access permission settings. `UNPUBLISHED`: The video is available only to administrators.
duration	google.protobuf.Duration Total duration of the video. Optional, may be empty until the transcoding result is ready.
auto_transcode	enum AutoTranscode Auto-transcoding setting that controls the video processing workflow. Set ENABLE to automatically initiate transcoding after upload, or DISABLE for manual initiation via the Transcode() method. `AUTO_TRANSCODE_UNSPECIFIED`: The auto-transcoding setting is not specified. `ENABLE`: Automatically start transcoding after the video upload is complete. `DISABLE`: Do not automatically transcode; requires manual initiation via the Transcode() method.
style_preset_id	string Identifier of the style preset applied to the video during processing.
enable_ad	google.protobuf.BoolValue Controls the ability to display advertisements for this video. Default: true. Set explicitly to false to disable advertisements for a specific video.
subtitle_ids[]	string List of identifiers defining the active subtitles available for the video.
features	VideoFeatures Additional video processing features and their results, such as summarization.
tusd	VideoTUSDSource Upload video using the TUS (Tus Resumable Upload Protocol) protocol. @see https://tus.io/ Includes only one of the fields `tusd`. Specifies the video upload source method (one source variant must be chosen).
public_access	VideoPublicAccessRights Allows unrestricted public access to the video via direct link. No additional authorization or access control is applied. Includes only one of the fields `public_access`, `sign_url_access`. Specifies the video access permission settings.
sign_url_access	VideoSignURLAccessRights Restricts video access using URL signatures for secure time-limited access. Includes only one of the fields `public_access`, `sign_url_access`. Specifies the video access permission settings.
created_at	google.protobuf.Timestamp Timestamp when the video was initially created in the system.
updated_at	google.protobuf.Timestamp Timestamp of the last modification to the video or its metadata.
labels	object (map<string, string>) Custom user-defined labels as `key:value` pairs. Maximum 64 labels per video. Labels can be used for organization, filtering, and metadata purposes.

VideoFeatures

Contains additional processing features and their results for the video.

Field

Description

summary

Summary

Results of the video content summarization process.

Summary

Contains the results of video summarization.

Field

Description

result

enum FeatureResult

Current status of the summarization process.

FEATURE_RESULT_UNSPECIFIED: The feature result status is not specified.
NOT_REQUESTED: The feature processing has not been requested.
PROCESSING: The feature is currently being processed.
SUCCESS: The feature processing has completed successfully.
FAILED: The feature processing has failed.

urls[]

SummaryURL

List of URLs to summarization results for different audio tracks.

SummaryURL

Contains a URL to a summarization result for a specific audio track.

Field	Description
url	string URL to the summarization result file.
track_index	int64 Input audio track index (one-based) that was summarized.
src_lang	string Source track language represented as a three-letter code according to ISO 639-2/T.

VideoTUSDSource

Represents a video upload source using the TUS (Tus Resumable Upload Protocol) protocol.
This is a push-based upload method where the client pushes data to the server.
@see https://tus.io/

Field

Description

url

string

URL endpoint for uploading the video via the TUS protocol.

file_size

int64

Total size of the uploaded file, in bytes.

VideoPublicAccessRights

Represents public access rights for a video.
When this access type is set, the video is publicly accessible via direct link.

Field	Description
Empty

VideoSignURLAccessRights

Represents access rights controlled by URL signatures.
When this access type is set, the video is accessible only via properly signed temporary link.

Field	Description
Empty

Video API, gRPC: VideoService.Create

gRPC requestgRPC request

CreateVideoRequestCreateVideoRequest

VideoTUSDParamsVideoTUSDParams

VideoPublicAccessParamsVideoPublicAccessParams

VideoSignURLAccessParamsVideoSignURLAccessParams

operation.Operationoperation.Operation

CreateVideoMetadataCreateVideoMetadata

VideoVideo

VideoFeaturesVideoFeatures

SummarySummary

SummaryURLSummaryURL

VideoTUSDSourceVideoTUSDSource

VideoPublicAccessRightsVideoPublicAccessRights

VideoSignURLAccessRightsVideoSignURLAccessRights

Была ли статья полезна?

gRPC request

CreateVideoRequest

VideoTUSDParams

VideoPublicAccessParams

VideoSignURLAccessParams

operation.Operation

CreateVideoMetadata

Video

VideoFeatures

Summary

SummaryURL

VideoTUSDSource

VideoPublicAccessRights

VideoSignURLAccessRights