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 資源。這項資源:

  • 您必須指定這些屬性的值:

    • broadcastId
    • settings.cueType

  • 您可以設定以下屬性的值:

    • settings.offsetTimeMs
    • settings.walltime
    • settings.durationSecs

回應

如果成功,此方法會在回應主體中傳回 liveCuepoint 資源

錯誤

下表說明 API 在回應此方法時可能傳回的錯誤訊息。詳情請參閱錯誤訊息說明文件。

錯誤類型 錯誤詳細資料 說明
invalidValue (400) conflictingTimeFields 您只能指定 offsetTimeMswalltime 其中之一。