Method: liveCuepoints.insert
Stay organized with collections
Save and categorize content based on your preferences.
Inserts a cuepoint into a live broadcast.
HTTP request
POST https://youtubepartner.googleapis.com/youtube/partner/v1/liveCuepoints
The URL uses gRPC Transcoding
syntax.
Query parameters
| Parameters |
channelId
|
string
The channelId
parameter identifies the channel that owns the broadcast into which the cuepoint is being inserted.
|
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
The request body contains an instance of LiveCuepoint
.
Response body
If successful, the response body contains a newly created instance of LiveCuepoint
.
Authorization scopes
Requires the following OAuth scope:
-
https://www.googleapis.com/auth/youtubepartner
For more information, see the OAuth 2.0 Overview
.
All rights reserved. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-20 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-20 UTC."],[[["\u003cp\u003eThis API allows inserting a cuepoint into a live broadcast via a POST request to a specific URL.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires specifying a \u003ccode\u003echannelId\u003c/code\u003e to identify the broadcast's owner and an optional \u003ccode\u003eonBehalfOfContentOwner\u003c/code\u003e parameter for users managing multiple content owners.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must contain an instance of \u003ccode\u003eLiveCuepoint\u003c/code\u003e, and a successful response returns a new instance of it.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization to use this API requires the \u003ccode\u003ehttps://www.googleapis.com/auth/youtubepartner\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],["This document details inserting a cuepoint into a live YouTube broadcast using a POST request to `https://youtubepartner.googleapis.com/youtube/partner/v1/liveCuepoints`. The request requires `channelId` and optionally `onBehalfOfContentOwner` as query parameters. The request body must include a `LiveCuepoint` instance. Successful requests return a newly created `LiveCuepoint` instance in the response body. Authorization requires the `https://www.googleapis.com/auth/youtubepartner` OAuth scope.\n"],null,["# Method: liveCuepoints.insert\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nInserts a cuepoint into a live broadcast.\n\n### HTTP request\n\n`POST https://youtubepartner.googleapis.com/youtube/partner/v1/liveCuepoints`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|--------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `channelId` | `string` The `channelId` parameter identifies the channel that owns the broadcast into which the cuepoint is being inserted. |\n| `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](/youtube/partner/reference/rest/v1/contentOwners/list) method. |\n\n### Request body\n\nThe request body contains an instance of [LiveCuepoint](/youtube/partner/reference/rest/v1/liveCuepoints#LiveCuepoint).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [LiveCuepoint](/youtube/partner/reference/rest/v1/liveCuepoints#LiveCuepoint).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/youtubepartner`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
