Method: videoTrainability.get

  • This API endpoint retrieves the trainability status of a specified video.

  • The HTTP request is a GET request to the videoTrainability endpoint, and it uses gRPC Transcoding syntax.

  • The video is identified by its ID, which is passed as a query parameter.

  • The response includes details such as the video ID, resource kind, Etag, and a list of who is permitted to train on the video.

  • The request body for this endpoint must be empty.

Returns the trainability status of a video.

HTTP request

GET https://youtube.googleapis.com/youtube/v3/videoTrainability

The URL uses gRPC Transcoding syntax.

Query parameters

Parameters
id

string

The ID of the video to retrieve.

Request body

The request body must be empty.

Response body

Specifies who is allowed to train on the video.

If successful, the response body contains data with the following structure:

JSON representation 
{
  "videoId": string,
  "kind": string,
  "etag": string,
  "permitted": [
    string
  ]
}
Fields
videoId

string

The ID of the video.
kind

string

Identifies what kind of resource this is. Value: the fixed string "youtube#videoTrainability"
etag

string

Etag of this resource.
permitted[]

string

Specifies who is allowed to train on the video. Valid values are:

  • A single string "all"
  • A single string "none"
  • A list of allowed parties