LiveCuepoints: insert
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
このメソッドは非推奨になり、liveBroadcasts.cuepoint
メソッドに置き換えられました。
ライブ ブロードキャストにキューポイントを挿入します。現在、このメソッドへのリクエストは YouTube コンテンツ所有者に関連付けられたアカウントで承認される必要があります。
リクエスト
HTTP リクエスト
POST https://www.googleapis.com/youtube/partner/v1/liveCuepoints
承認
このリクエストは、少なくとも次のうち 1 つのスコープでの承認が必要です(認証と承認の詳細をご確認ください)。
範囲 |
https://www.googleapis.com/auth/youtubepartner |
パラメータ
次の表に、このクエリがサポートするパラメータを示します。このリストのパラメータはすべてクエリ パラメータです。
パラメータ |
必須パラメータ |
channelId |
string
channelId パラメータは、キューポイントが挿入されるブロードキャストを所有するチャンネルを識別します。 |
onBehalfOfContentOwner |
string
onBehalfOfContentOwner パラメータは、ユーザーが代理を務めるコンテンツ所有者を識別します。 |
リクエスト本文
リクエストの本文に liveCuepoint リソースを指定します。対象リソース:
-
以下のプロパティの値を指定する必要があります。
broadcastId
settings.cueType
-
以下のプロパティの値を設定することができます。
settings.offsetTimeMs
settings.walltime
settings.durationSecs
エラー
次の表に、このメソッドの呼び出しに応じて API から返される可能性のあるエラー メッセージを示します。詳細については、エラー メッセージのドキュメントを参照してください。
エラーのタイプ |
エラーの詳細 |
説明 |
invalidValue (400) |
conflictingTimeFields |
offsetTimeMs と walltime のどちらか一方のみを指定できます。 |
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2023-02-22 UTC。
[[["わかりやすい","easyToUnderstand","thumb-up"],["問題の解決に役立った","solvedMyProblem","thumb-up"],["その他","otherUp","thumb-up"]],[["必要な情報がない","missingTheInformationINeed","thumb-down"],["複雑すぎる / 手順が多すぎる","tooComplicatedTooManySteps","thumb-down"],["最新ではない","outOfDate","thumb-down"],["翻訳に関する問題","translationIssue","thumb-down"],["サンプル / コードに問題がある","samplesCodeIssue","thumb-down"],["その他","otherDown","thumb-down"]],["最終更新日 2023-02-22 UTC。"],[[["\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,[]]