Yandex Cloud
Search
Contact UsGet started
  • Blog
  • Pricing
  • Documentation
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • AI Studio
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Customer Stories
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Education and Science
    • Yandex Cloud Partner program
  • Blog
  • Pricing
  • Documentation
© 2025 Direct Cursus Technology L.L.C.
Yandex Cloud Video
    • Overview
    • Control
    • Troubleshooting
  • Access management
  • Pricing policy
    • Authentication with the API
    • Getting started with the API
      • Overview
        • Overview
        • Get
        • List
        • BatchGet
        • Create
        • Update
        • Delete
        • BatchDelete
        • PerformAction
        • GetPlayerURL
        • GetManifests
  • Audit Trails events
  • Release notes

In this article:

  • gRPC request
  • BatchGetEpisodesRequest
  • BatchGetEpisodesResponse
  • Episode
  • EpisodePublicAccessRights
  • EpisodeAuthSystemAccessRights
  • EpisodeSignURLAccessRights
  1. API reference
  2. gRPC
  3. Episode
  4. BatchGet

Video API, gRPC: EpisodeService.BatchGet

Written by
Yandex Cloud
Updated at April 24, 2025
  • gRPC request
  • BatchGetEpisodesRequest
  • BatchGetEpisodesResponse
  • Episode
  • EpisodePublicAccessRights
  • EpisodeAuthSystemAccessRights
  • EpisodeSignURLAccessRights

Batch get episodes for channel.

gRPC requestgRPC request

rpc BatchGet (BatchGetEpisodesRequest) returns (BatchGetEpisodesResponse)

BatchGetEpisodesRequestBatchGetEpisodesRequest

{
  "channel_id": "string",
  "episode_ids": [
    "string"
  ]
}

Field

Description

channel_id

string

Required field. ID of the channel.

episode_ids[]

string

List of requested episode IDs.

BatchGetEpisodesResponseBatchGetEpisodesResponse

{
  "episodes": [
    {
      "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",
      // Includes only one of the fields `public_access`, `auth_system_access`, `sign_url_access`
      "public_access": "EpisodePublicAccessRights",
      "auth_system_access": "EpisodeAuthSystemAccessRights",
      "sign_url_access": "EpisodeSignURLAccessRights",
      // end of the list of possible fields
      "created_at": "google.protobuf.Timestamp",
      "updated_at": "google.protobuf.Timestamp"
    }
  ]
}

Field

Description

episodes[]

Episode

List of episodes for specific channel.

EpisodeEpisode

Field

Description

id

string

ID of the episode.

stream_id

string

ID of the stream. Optional, empty if the episode is linked to the line

line_id

string

ID of the line. Optional, empty if the episode is linked to the stream

title

string

Episode title.

description

string

Episode description.

thumbnail_id

string

ID of the thumbnail.

start_time

google.protobuf.Timestamp

Episode start time.

finish_time

google.protobuf.Timestamp

Episode finish time.

dvr_seconds

int64

Enables episode DVR mode.
Determines how many last seconds of the stream are available for watching.

Possible values:

  • 0: infinite dvr size, the full length of the stream allowed to display
  • >0: size of dvr window in seconds, the minimum value is 30s

visibility_status

enum VisibilityStatus

  • VISIBILITY_STATUS_UNSPECIFIED
  • PUBLISHED
  • UNPUBLISHED

public_access

EpisodePublicAccessRights

Episode is available to everyone.

Includes only one of the fields public_access, auth_system_access, sign_url_access.

Episode access rights.

auth_system_access

EpisodeAuthSystemAccessRights

Checking access rights using the authorization system.

Includes only one of the fields public_access, auth_system_access, sign_url_access.

Episode access rights.

sign_url_access

EpisodeSignURLAccessRights

Checking access rights using url's signature.

Includes only one of the fields public_access, auth_system_access, sign_url_access.

Episode access rights.

created_at

google.protobuf.Timestamp

Time when episode was created.

updated_at

google.protobuf.Timestamp

Time of last episode update.

EpisodePublicAccessRightsEpisodePublicAccessRights

Field

Description

Empty

EpisodeAuthSystemAccessRightsEpisodeAuthSystemAccessRights

Field

Description

Empty

EpisodeSignURLAccessRightsEpisodeSignURLAccessRights

Field

Description

Empty

Was the article helpful?

Previous
List
Next
Create
© 2025 Direct Cursus Technology L.L.C.