Inserts a cuepoint into a live broadcast. Try it now.
Request
HTTP request
POST https://www.googleapis.com/youtube/partner/v1/liveCuepoints
Authorization
This request requires authorization with at least one of the following scopes (read more about authentication and authorization).
Scope |
---|
https://www.googleapis.com/auth/youtubepartner |
Parameters
The table below lists the parameters that this query supports. All of the parameters listed are query parameters.
Parameter name | Value | Description |
---|---|---|
Required parameters | ||
channelId |
string |
The channelId parameter identifies the channel that owns the broadcast into which the cuepoint is being inserted. |
Optional parameters | ||
onBehalfOfContentOwner |
string |
The onBehalfOfContentOwner parameter identifies the content owner that the user is acting on behalf of. This parameter supports users whose accounts are associated with multiple content owners. You can obtain the content owner ID that will serve as the parameter value by calling the YouTube Content ID API's contentOwners.list method. |
Request body
Provide a liveCuepoint resource in the request body. For that resource:
-
You must specify a value for these properties:
broadcastId
settings.cueType
-
You can set values for these properties:
settings.offsetTimeMs
settings.durationSecs
settings.walltime
Response
If successful, this method returns a liveCuepoint resource in the response body.
Errors
The table below identifies error messages that the API could return in response to a call to this method. Please see the error message documentation for more detail.
Error type | Error detail | Description |
---|---|---|
invalidValue (400) |
conflictingTimeFields |
Only one of offsetTimeMs and walltime may be specified. |
Try it!
Use the API Explorer to call this method on live data and see the API request and response.