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
    • ML & AI
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Customer Stories
    • 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
        • Create
        • Update
        • Delete
        • BatchDelete
        • ListAccessBindings
        • SetAccessBindings
        • UpdateAccessBindings
  • Audit Trails events
  • Release notes

In this article:

  • HTTP request
  • Path parameters
  • Response
  • ChannelSettings
  • AdvertisementSettings
  • YandexDirect
  • RefererVerificationSettings
  1. API reference
  2. REST
  3. Channel
  4. Get

Video API, REST: Channel.Get

Written by
Yandex Cloud
Updated at April 24, 2025
  • HTTP request
  • Path parameters
  • Response
  • ChannelSettings
  • AdvertisementSettings
  • YandexDirect
  • RefererVerificationSettings

Get the specific channel.

HTTP requestHTTP request

GET https://video.api.cloud.yandex.net/video/v1/channels/{channelId}

Path parametersPath parameters

Field

Description

channelId

string

Required field. ID of the channel.

ResponseResponse

HTTP Code: 200 - OK

{
  "id": "string",
  "organizationId": "string",
  "title": "string",
  "description": "string",
  "createdAt": "string",
  "updatedAt": "string",
  "labels": "object",
  "settings": {
    "advertisement": {
      // Includes only one of the fields `yandexDirect`
      "yandexDirect": {
        "enable": "boolean",
        "pageId": "string",
        "category": "string"
      }
      // end of the list of possible fields
    },
    "refererVerification": {
      "enable": "boolean",
      "allowedDomains": [
        "string"
      ]
    }
  }
}

Root entity for content separation.

Field

Description

id

string

ID of the channel.

organizationId

string

ID of the organization where channel should be created.

title

string

Channel title.

description

string

Channel description.

createdAt

string (date-time)

Time when channel was created.

String in RFC3339 text format. The range of possible values is from
0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z, i.e. from 0 to 9 digits for fractions of a second.

To work with values in this field, use the APIs described in the
Protocol Buffers reference.
In some languages, built-in datetime utilities do not support nanosecond precision (9 digits).

updatedAt

string (date-time)

Time of last channel update.

String in RFC3339 text format. The range of possible values is from
0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z, i.e. from 0 to 9 digits for fractions of a second.

To work with values in this field, use the APIs described in the
Protocol Buffers reference.
In some languages, built-in datetime utilities do not support nanosecond precision (9 digits).

labels

object (map<string, string>)

Custom labels as key:value pairs. Maximum 64 per resource.

settings

ChannelSettings

Channel settings.

ChannelSettingsChannelSettings

Channel settings.

Field

Description

advertisement

AdvertisementSettings

Advertisement settings.

refererVerification

RefererVerificationSettings

Referer verification settings

AdvertisementSettingsAdvertisementSettings

Advertisement settings.

Field

Description

yandexDirect

YandexDirect

Includes only one of the fields yandexDirect.

Advertisement provider.

YandexDirectYandexDirect

YandexDirect provider settings.

Field

Description

enable

boolean

Enable Partner Ad for Live and VOD content.

pageId

string (int64)

Advertisement page ID.

category

string (int64)

Advertisement category.

RefererVerificationSettingsRefererVerificationSettings

Referer verification settings.

Field

Description

enable

boolean

Enable verification

allowedDomains[]

string

List of available domains

Was the article helpful?

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