エピソードリストのエピソードを更新します。
使用状況ノート
この操作を呼び出して、エピソードリスト内のエピソードのすべての構成を更新したり、エピソードを置き換えたりできます。
QPS制限
1人のユーザーが1秒あたり最大10件のクエリ (QPS) を実行できます。 Throttling is triggered when the number of calls per second exceeds the QPS limit. The throttling may affect your business. Thus, we recommend that you observe the QPS limit on this operation. For more information about what a single user means and the QPS details, see QPS limit on an API operation in ApsaraVideo Live.
デバッグ
リクエストパラメーター
パラメーター | データ型 | 必須/任意 | 例 | 説明 |
---|---|---|---|---|
操作 | String | 必須 | EditPlaylist |
実行する操作です。 値を 編集プレイリスト。 |
ProgramId | String | 必須 | 445409ec-7eaa-461d-8f29-4bec2eb9 **** |
変更するエピソードリストのID。 AddPlaylistItems 操作を呼び出したときの応答に含まれます。 |
ProgramItems | String | 必須 | [{"ItemName": "item1","ResourceType": "vod","ResourceValue": "5f8809f2-3352-4d1f-a8f7-86f9429f ****"}, {"ItemName": "item2","ResourceType": "vod","ResourceValue": "e7411c0b-dd98-4c61-a545-f8bfba6c ****"}] |
変更または追加するエピソード。 値はJSON文字列です。 詳細については、このトピックのInputProgramItemセクションを参照してください。 |
ProgramConfig | String | 任意 | [{"RepeatNumber":"0","ProgramName":"my program"}] |
変更または追加するエピソードの新しい構成です。 詳細については、このトピックのProgramConfigセクションを参照してください。 |
InputProgramItem
パラメーター |
例 |
タイプ |
説明 |
---|---|---|---|
ItemName |
item1 |
String |
エピソードの名前。 |
ResourceType |
vod |
String |
エピソードリソースのタイプ。 有効な値は vod。 ビデオオンデマンド (VOD) リソースのみがサポートされています。 |
ResourceValue |
5f8809f2-3352-4d1f-a8f7-86f9429f **** |
String |
エピソードリソースのID。 |
ProgramConfig
パラメーター |
例 |
タイプ |
説明 |
---|---|---|---|
RepeatNumber |
0 |
Integer |
最初の再生が完了した後にエピソードが繰り返される回数。 設定可能な値は以下のとおりです。 0: エピソードを1回だけ再生するように指定します。 デフォルト値です。 -1: エピソードをループモードで再生することを指定します。 正の整数: 最初の再生が完了した後にエピソードが繰り返される回数を指定します。 |
プログラム名 |
myprogram |
String |
変更するエピソードリストの名前。 |
レスポンスパラメーター
パラメーター | データ型 | 例 | 説明 |
---|---|---|---|
CasterId | String | 0e94d1f4-1a65-445c-9dcf-de8b3b8d **** |
ストリーミングパネルのID。 |
Items | Struct |
The information about the episodes that you want to modify or add. |
|
FailedItems | Array of FailedItem |
The episodes that failed to be modified or added. |
|
ItemId | String | c09f3d63-eacf-4fbf-bd48-a07a6ba7 **** |
エピソードのID。 |
ItemName | String | item2 |
エピソードの名前。 |
成功アイテム | SuccessItemの配列 |
変更または追加されたエピソード。 |
|
ItemId | String | c09f3d63-eacf-4fbf-bd48-a07a6ba7 **** |
エピソードのID。 |
ItemName | String | item1 |
エピソードの名前。 |
ProgramId | String | 445409ec-7eaa-461d-8f29-4bec2eb9 **** |
変更されたエピソードリストのID。 |
RequestId | String | 5c6a2a0d-f228-4a64-af62-20e91b96 **** |
リクエストの ID です。 |
例
リクエストの例
http(s):// live.aliyuncs.com/?Action=EditPlaylist
&ProgramId=445409ec-7eaa-461d-8f29-4bec2eb9 ****
&ProgramItems=[{"ItemName": "item1","ResourceType": "vod","ResourceValue": "5f8809f2-3352-4d1f-a8f7-86f9429f ****"}, {"ItemName": "item2","ResourceType": "vod","ResourceValue": "e7411c0b-dd98-4c61-a545-f8bfba6c ****"}]
&<共通リクエストパラメーター>
正常に処理された場合のレスポンス例
XML
形式
<EditPlaylistResponse>
<RequestId>5c6a2a0d-f228-4a64-af62-20e91b96 ****</RequestId>
<Items>
<FailedItems>
<ItemName>item2</ItemName>
<ItemId>c09f3d63-eacf-4fbf-bd48-a07a6ba7 ****</ItemId>
</FailedItems>
<SuccessItems>
<ItemName>item1</ItemName>
<ItemId>c09f3d63-eacf-4fbf-bd48-a07a6ba7 ****</ItemId>
</SuccessItems>
</Items>
<ProgramId>445409ec-7eaa-461d-8f29-4bec2eb9 ****</ProgramId>
<CasterId>0e94d1f4-1a65-445c-9dcf-de8b3b8d ****</CasterId>
</EditPlaylistResponse>
JSON
形式
{
"RequestId":"5c6a2a0d-f228-4a64-af62-20e91b96 ****" 、
"Items":{
"FailedItems":[{
"ItemName":"item2" 、
"ItemId":"c09f3d63-eacf-4fbf-bd48-a07a6ba7 ****"
}],
"SuccessItems":[{
"ItemName":"item1" 、
"ItemId":"c09f3d63-eacf-4fbf-bd48-a07a6ba7 ****"
}]
},
"ProgramId":"445409ec-7eaa-461d-8f29-4bec2eb9 ****" 、
"CasterId":"0e94d1f4-1a65-445c-9dcf-de8b3b8d ****"
}
エラーコード
エラーコードリストについては、「API エラーセンター」をご参照ください。