LiveCuepoints: insert
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
此方法已淘汰，並由 liveBroadcasts.cuepoint 方法取代。
將提示點插入現場直播中。目前，要傳送這個方法的要求必須由 YouTube 內容擁有者相關聯的帳戶進行授權。
要求
HTTP 要求
POST https://www.googleapis.com/youtube/partner/v1/liveCuepoints
授權
此要求需要至少具備下列其中一個範圍的授權 (進一步瞭解驗證和授權)。
| 範圍 |
|---|
https://www.googleapis.com/auth/youtubepartner |
參數
下表列出這項查詢支援的參數。上方列出的所有參數都是查詢參數。
| 參數 |
| 必要參數 |
channelId |
string
channelId 參數可識別插入提示點的廣播所屬頻道。 |
onBehalfOfContentOwner |
string
onBehalfOfContentOwner 參數可識別使用者所代表的內容擁有者。 |
要求主體
在要求主體中提供 liveCuepoint 資源。這項資源：
-
您必須指定這些屬性的值：
broadcastIdsettings.cueType
-
您可以設定以下屬性的值：
settings.offsetTimeMssettings.walltimesettings.durationSecs
錯誤
下表說明 API 在回應此方法時可能傳回的錯誤訊息。詳情請參閱錯誤訊息說明文件。
| 錯誤類型 |
錯誤詳細資料 |
說明 |
invalidValue (400) |
conflictingTimeFields |
您只能指定 offsetTimeMs 和 walltime 其中之一。 |
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2023-02-22 (世界標準時間)。
[null,null,["上次更新時間：2023-02-22 (世界標準時間)。"],[[["\u003cp\u003eThis API method for inserting a cuepoint into a live broadcast has been deprecated and is now replaced by the \u003ccode\u003eliveBroadcasts.cuepoint\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eUsing this method requires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/youtubepartner\u003c/code\u003e scope and being associated with a YouTube Content Owner.\u003c/p\u003e\n"],["\u003cp\u003eThe required parameters for this method are \u003ccode\u003echannelId\u003c/code\u003e, which identifies the channel owning the broadcast, and \u003ccode\u003eonBehalfOfContentOwner\u003c/code\u003e, which identifies the content owner.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must include a \u003ccode\u003eliveCuepoint\u003c/code\u003e resource with specified values for \u003ccode\u003ebroadcastId\u003c/code\u003e and \u003ccode\u003esettings.cueType\u003c/code\u003e, and can optionally set \u003ccode\u003esettings.offsetTimeMs\u003c/code\u003e, \u003ccode\u003esettings.walltime\u003c/code\u003e, or \u003ccode\u003esettings.durationSecs\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe API returns a \u003ccode\u003eliveCuepoint\u003c/code\u003e resource upon success, and an error, such as \u003ccode\u003einvalidValue (400)\u003c/code\u003e for \u003ccode\u003econflictingTimeFields\u003c/code\u003e is returned if there are any errors.\u003c/p\u003e\n"]]],["This API method, now deprecated, was used to insert a cuepoint into a live broadcast via a POST request to `https://www.googleapis.com/youtube/partner/v1/liveCuepoints`. Authorization via the `https://www.googleapis.com/auth/youtubepartner` scope was required. Requests needed the `channelId` and `onBehalfOfContentOwner`. The request body required the `broadcastId` and `settings.cueType` properties to be set in a `liveCuepoint` resource. One of `offsetTimeMs` and `walltime` is valid. A successful response returned the `liveCuepoint` resource.\n"],null,["# LiveCuepoints: insert\n\nThis method has been deprecated and replaced by the\n[liveBroadcasts.cuepoint](/youtube/v3/live/docs/liveBroadcasts/cuepoint) method.\nInserts a cuepoint into a live broadcast. Currently, requests to this\nmethod must be authorized by an account associated with a YouTube\nContent Owner.\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/youtube/partner/v1/liveCuepoints\n```\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes ([read more about authentication and authorization](/youtube/v3/live/authentication)).\n\n| Scope |\n|--------------------------------------------------|\n| `https://www.googleapis.com/auth/youtubepartner` |\n\n### Parameters\n\nThe following table lists the parameters that this query supports. All of the parameters listed are query parameters.\n\n| Parameters ||\n|--------------------------|--------------------------------------------------------------------------------------------------------------------------------|---|\n| **Required parameters** |||\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. |\n\n### Request body\n\nProvide a [liveCuepoint resource](/youtube/v3/live/docs/liveCuepoints#resource) in the request body.\nFor that resource:\n\n- You must specify a value for these properties:\n\n \u003cbr /\u003e\n\n - `broadcastId`\n - `settings.cueType`\n\n \u003cbr /\u003e\n\n- You can set values for these properties:\n\n \u003cbr /\u003e\n\n - `settings.offsetTimeMs`\n - `settings.walltime`\n - `settings.durationSecs`\n\n \u003cbr /\u003e\n\nResponse\n--------\n\nIf successful, this method returns a [liveCuepoint resource](/youtube/v3/live/docs/liveCuepoints#resource) in the response body.\n\nErrors\n------\n\nThe following table identifies error messages that the API could return in response to a call to this method. Please see the [error message](/youtube/v3/live/docs/errors) documentation for more detail.\n\n| Error type | Error detail | Description |\n|----------------------|-------------------------|-------------------------------------------------------------|\n| `invalidValue (400)` | `conflictingTimeFields` | Only one of `offsetTimeMs` and `walltime` may be specified. |"]]
