カルーセル再生用のプロダクションスタジオにエピソードリストを追加します。

使用状況ノート

この操作を呼び出すと、1つのパラメーターContentにプログラム (エピソードリスト) の詳細を含めることができます。

QPS制限

1人のユーザーが1秒あたり最大4クエリ (QPS) を実行できます。 1秒あたりの呼び出し数がQPS制限を超えると、スロットリングがトリガーされます。 スロットルはビジネスに影響を与える可能性があります。 したがって、この操作のQPS制限を遵守することをお勧めします。 シングルユーザーの意味とQPSの詳細については、「ApsaraVideo LiveのAPI操作のQPS制限」をご参照ください。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター データ型 必須／任意 例 説明
操作 String 必須 AddCasterEpisodeGroupContent

実行したい操作。 値をAddCasterEpisodeGroupContentに設定します。

ClientTokend String 必須 8751ad99-2ddb-4aac-ad44-84b21102 ****

リクエストのべき等性を保証するために使用されるクライアントトークンです。

クライアントを使用してトークンを生成できますが、トークンが異なるリクエスト間で一意であることを確認する必要があります。 トークンにはASCII文字のみを使用でき、長さは64文字を超えることはできません。
Content String 必須 {"CallbackUrl":"http://example.aliyundoc.com/callBackLive","SideOutputUrl":"rtmp:// guide.aliyundoc.com/caster/4a82a3d1b7f0462ea37348366201****?auth_key=1608953344-0-0-ac8c628078541d7055a170ec59a5****","DomainName":"developer.aliyundoc.com","StartTime":"2018-03-26T16:00:00Z","RepeatNum":-1,"Items":":[{" ItemName ":" Episodeel "}" "" "http://learn.aliyundoc.com,"} "VodUrl":"http://demo.aliyundoc.com"}]}

エピソードリストに関する情報。 The value is a JSON string. 文字列のフィールドには上部ラクダケースを使用します。 このパラメータには、次のフィールドが含まれます。

  • CallbackUrl: コールバックURL。
  • SideOutputUrl: カスタムスタンバイURL。
  • RepeatNum: 最初の再生が完了した後にエピソードリストが繰り返される回数。 0の値は、エピソードリストが1回だけ再生されることを示す。 A value of -1 indicates that the episode list is played in loop mode.
  • DomainName: ドメイン名。
  • StartTime: エピソードリストの再生が開始された時刻。 ISO 8601標準のyyyy-MM-dd T HH:mm:ss Z形式で時刻を指定します。 時刻はUTCである必要があります。
  • アイテム: エピソードリストに関する情報。 ItemNameとVodUrlの配列です。
    • ItemName: エピソードの名前。
    • VodUrl: VODファイルのURL。 このフィールドは、ビデオリソースがメディアライブラリからのものではないビデオファイルである場合にのみ有効になります。 ビデオファイルは、MP4、FLV、またはTS形式である必要があります。
RegionId String 任意 cn-shanghai

リージョンの ID

レスポンスパラメーター

パラメーター データ型 例 説明
ItemIds List ["21926b36-7dd2-4fde-ae25-51b5bc8e ****", "21926b36-7dd2-4fde-ae25-51b5bc98 ****"]

リスト内のエピソードのID。
ProgramId String 16A96B9A-F203-4EC5-8E43-CB92E68X ****

追加されたエピソードリストのID。
RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

リクエストの ID です。

例

リクエストの例

http(s):// live.aliyuncs.com/?Action=AddCasterEpisodeGroupContent
&ClientToken=8751ad99-2ddb-4aac-ad44-84b21102 ****
&Content={"CallbackUrl":"http://example.aliyundoc.com/callBackLive","SideOutputUrl":"rtmp:// guide.aliyundoc.com/caster/4a82a3d1b7f0462ea37348366201****?auth_key=1608953344-0-0-ac8c628078541d7055a170ec59a5****","DomainName":"developer.aliyundoc.com","StartTime":"2018-03-26T16:00:00Z","RepeatNum":-1,"Items":"{" ItemName ":" "http://learn.aliyundoc.com" "" "," "VodUrl":"http://demo.aliyundoc.com"}]}
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式 

<AddCasterEpisodeGroupContentResponse>
      <RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
      <ProgramId>16A96B9A-F203-4EC5-8E43-CB92E68X****</ProgramId>
      <ItemIds>21926b36-7dd2-4fde-ae25-51b5bc8e****</ItemIds>
      <ItemIds>21926b36-7dd2-4fde-ae25-51b5bc98 ****</ItemIds>
</AddCasterEpisodeGroupContentResponse>

JSON 形式 

{
    "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
    "ProgramId": "16A96B9A-F203-4EC5-8E43-CB92E68X****",
    "ItemIds": [
      "21926b36-7dd2-4fde-ae25-51b5bc8e ****" 、
      "21926b36-7dd2-4fde-ae25-51b5bc98****"
    ]
}

エラーコード

エラーコードリストについては、「API エラーセンター」をご参照ください。