プレイリストに番組を追加します。
操作説明
このオペレーションを呼び出す前に、ニア VOD モードのプロダクションスタジオ (NormType=6) を作成し、ビデオリソースを追加してください。API オペレーションを使用してプロダクションスタジオを作成する方法については、「 CreateCaster 」を参照してください。
各プレイリストには最大 1000 の番組を含めることができます。
-
Video-on-Demand (VOD) リソースを使用する場合は、まずマネージドバケットリソースを使用してください。独自のバケット内のリソースは有効期限切れになる可能性があります。独自のバケット内のリソースを使用する場合は、リソースの有効期間を確認してください。
-
プロダクションスタジオの入力として ApsaraVideo Live および ApsaraVideo VOD リソースを使用してください。サードパーティ URL のリソースは再生に失敗する可能性があります。そのようなリソースの品質と有効性を確認してください。
QPS 制限
このオペレーションの単一ユーザー QPS 制限は、1 秒あたり 10 回の呼び出しです。この制限を超えると、API 呼び出しがスロットリングされ、ビジネスに影響が出る可能性があります。このオペレーションは適切に呼び出してください。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
live:AddShowIntoShowList |
create |
*Caster
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| RegionId |
string |
任意 |
リージョン ID。 |
cn-shanghai |
| showList |
array<object> |
任意 |
追加する番組リソースのリスト。各リソースには、showName や resourceUrl などの独立したパラメーターがあります。 |
|
|
object |
任意 |
プロダクションスタジオのリスト情報。 |
||
| duration |
integer |
任意 |
単一番組の再生持続時間。単位: 秒。 説明
|
20 |
| liveInputType |
integer |
任意 |
カスタムタイプタグ。 |
1 |
| repeatTimes |
integer |
任意 |
単一番組の繰り返し回数。デフォルト値: 0。 説明
|
0 |
| resourceId |
string |
任意 |
VOD ファイル ID。 |
a2b8e671-2fe5-4642-a2ec-bf93880e**** |
| resourceType |
string |
任意 |
リソースタイプ。有効な値:
説明
|
vod |
| resourceUrl |
string |
任意 |
再生ファイルの URL。 |
http://****/atestObject****.m3u8 |
| showName |
string |
任意 |
番組名。 |
liveShow**** |
| CasterId |
string |
必須 |
プロダクションスタジオ ID。
説明
ApsaraVideo Live コンソールのクラウドプロダクションスタジオページにあるプロダクションスタジオリスト内のプロダクションスタジオ名が、プロダクションスタジオ ID です。 |
LIVEPRODUCER_POST-cn-0pp1czt**** |
| ShowName |
string |
任意 |
番組名。 |
liveShow**** |
| ResourceType |
string |
任意 |
リソースタイプ。有効な値:
説明
|
vod |
| ResourceUrl |
string |
任意 |
再生ファイルの URL。 |
http://****/atestObject****.m3u8 |
| ResourceId |
string |
任意 |
VOD ファイル ID。 |
a2b8e671-2fe5-4642-a2ec-bf93880e**** |
| Duration |
integer |
任意 |
単一番組の再生持続時間。単位: 秒。 説明
|
20 |
| RepeatTimes |
integer |
任意 |
単一番組の繰り返し回数。デフォルト値: 0。 説明
|
0 |
| Spot |
integer |
任意 |
番組が挿入されるプレイリスト内の位置。位置は 0 から始まります。デフォルトでは、番組は現在のプレイリストの末尾に追加されます。 |
1 |
| LiveInputType |
integer |
任意 |
カスタムタイプタグ。 |
1 |
| isBatchMode |
boolean |
任意 |
プレイリストに番組をバッチで追加するかどうかを指定します。有効な値:
説明
このパラメーターが指定されていないか空の場合、単一追加が使用されます。 |
false |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| RequestId |
string |
リクエスト ID。 |
987DA143-A39C-5B5D-AF5B-3B07944A0036 |
| ShowId |
string |
番組 ID。 |
a2b8e671-2fe5-4642-a2ec-bf93880e**** |
| failedList |
string |
追加に失敗したリソースのリストおよび失敗理由。 |
failedList[Show1, Show2...] |
| successfulShowIds |
string |
正常に追加された番組 ID のリスト。 |
f1933f16-5467-4308-b3a9-e8d451a90999，547436b8-c839-4469-a2c0-704c1ce5ce00 |
例
成功レスポンス
JSONJSON
{
"RequestId": "987DA143-A39C-5B5D-AF5B-3B07944A0036",
"ShowId": "a2b8e671-2fe5-4642-a2ec-bf93880e****",
"failedList": "failedList[Show1, Show2...]",
"successfulShowIds": "f1933f16-5467-4308-b3a9-e8d451a90999，547436b8-c839-4469-a2c0-704c1ce5ce00"
}エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | InvalidUserId.Malformed | %s, please check userId. | 指定された userId が無効です。パラメーター値を確認してください。 |
| 400 | InvalidParameter.Malformed | There are invalid parameters: %s. | 次のパラメーターが無効です: %s。 |
| 400 | InvalidCasterId.Malformed | %s, please check and try again later. | CasterId パラメーターが無効です。パラメーターを確認して再試行してください。 |
| 400 | InvalidVodUrl.Malformed | %s, please check and try again later. | VodUrl パラメーターが無効です。確認して再試行してください。 |
| 400 | MissingParameter | %s. | 必須パラメーターが不足しています。 |
| 401 | IllegalOperation | %s, please check and try again later. | 操作が無効です。リクエストを確認して再試行してください。 |
| 500 | InternalError | %s, please try again later. | 内部エラーが発生しました。しばらくしてから再試行してください。 |
| 404 | InvalidCaster.NotFound | %s, please check and try again later. | プロダクションスタジオが存在しません。構成を確認して再試行してください。 |
| 404 | InvalidShowList.NotFound | %s, please check and try again later. | ShowList が存在しません。確認して再試行してください。 |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。