Video API, gRPC: VideoService.List
List videos for channel.
gRPC request
rpc List (ListVideoRequest) returns (ListVideoResponse)
ListVideoRequest
{
"channel_id": "string",
"page_size": "int64",
"page_token": "string",
"order_by": "string",
"filter": "string"
}
Field |
Description |
channel_id |
string Required field. ID of the channel. |
page_size |
int64 The maximum number of the results per page to return. |
page_token |
string Page token for getting the next page of the result. |
order_by |
string By which column the listing should be ordered and in which direction, |
filter |
string Filter expression that filters resources listed in the response. |
ListVideoResponse
{
"videos": [
{
"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",
"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>"
}
],
"next_page_token": "string"
}
Field |
Description |
videos[] |
|
next_page_token |
string Token for getting the next page. |
Video
Field |
Description |
id |
string ID of the video. |
channel_id |
string ID of the channel where the video was created. |
title |
string Video title displayed to users. |
description |
string Detailed description of the video. |
thumbnail_id |
string ID of the video's thumbnail image. |
status |
enum VideoStatus Video status.
|
error_message |
string Error message describing the reason for video processing failure, if any. |
visibility_status |
enum VisibilityStatus Visibility status of the video.
|
duration |
Video duration. Optional, may be empty until the transcoding result is ready. |
auto_transcode |
enum AutoTranscode Auto-transcoding setting.
|
enable_ad |
Enable advertisement for this video. |
subtitle_ids[] |
string List of IDs defining the active subtitles for the video. |
features |
Additional video processing features and their results. |
tusd |
Upload video using the tus protocol. Includes only one of the fields Video upload source definition (one source variant must be chosen). |
public_access |
Publicly accessible video available for viewing by anyone with the direct link. Includes only one of the fields Video access permission settings. |
sign_url_access |
Checking access rights using url's signature. Includes only one of the fields Video access permission settings. |
created_at |
Time when video was created. |
updated_at |
Time of last video update. |
labels |
object (map<string, string>) Custom labels as |
VideoFeatures
Field |
Description |
summary |
Summarization result. |
Summary
Field |
Description |
result |
enum FeatureResult
|
urls[] |
SummaryURL
Field |
Description |
url |
string |
track_index |
int64 Input audio track index (one-based). |
src_lang |
string Source track language (three-letter code according to ISO 639-2/T, ISO 639-2/B, or ISO 639-3). |
VideoTUSDSource
Video upload source via tus protocol.
Field |
Description |
url |
string URL for uploading video via the tus protocol. |
file_size |
int64 Size of the uploaded file, in bytes. |
VideoPublicAccessRights
Field |
Description |
Empty |
VideoSignURLAccessRights
Field |
Description |
Empty |