すべてのプロダクト
Search
ドキュメントセンター

:AddCasterEpisodeGroupContent

最終更新日:Dec 24, 2025

プロダクションスタジオのエピソードグループにコンテンツを追加します。

操作説明

この操作を呼び出す前に、プロダクションスタジオとエピソードグループを作成する必要があります。 詳細については、「プロダクションスタジオの作成」をご参照ください。

QPS 制限

この操作の 1 秒あたりのクエリ数 (QPS) は、ユーザーあたり 4 に制限されています。 制限を超えた場合、API 呼び出しはスロットリングされます。 これはビジネスに影響を及ぼす可能性があるため、呼び出しを適切に計画してください。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

live:AddCasterEpisodeGroupContent

create

*Domain

acs:live:*:{#accountId}:domain/{#DomainName}

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

RegionId

string

任意

リージョン ID。

cn-shanghai

ClientToken

string

必須

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

説明

この値はクライアントによって生成されます。 異なるリクエスト間で値がユニークであることを確認してください。 値は最大 64 文字の ASCII 文字列です。

8751ad99-2ddb-4aac-ad44-84b21102****

Content

string

必須

プロダクションスタジオのエピソードのプロパティ。 このパラメーターは JSON 文字列です。 パラメーター名はアッパーキャメルケースです。 プロパティは以下のとおりです:

  • CallbackUrl:Webhook アドレス。

  • SideOutputUrl:カスタムバイパス出力 URL。

  • RepeatNum:エピソードをループする回数。 値 0 はループなし、値 -1 は無期限ループを意味します。

  • StartTime:UTC での開始時刻。 フォーマットは yyyy-MM-ddTHH:mm:ssZ です。

  • DomainName:ドメイン名。

  • Items:エピソード内のアイテムのリスト。

    : エピソード内のアイテムのリスト。

    • ItemName:アイテム名。

    • VodUrl:ビデオオンデマンド (VOD) ファイルの URL。 このパラメーターは、リソースが素材ライブラリにインポートされていないビデオファイルである場合にのみ必須です。 MP4、FLV、および TS フォーマットがサポートされています。

{"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":"节目1","VodUrl":"http://learn.aliyundoc.com"},{"ItemName":"节目2","VodUrl":"http://demo.aliyundoc.com"}]}

レスポンスフィールド

フィールド

説明

object

ItemIds

object

ItemId

array

アイテム ID のリストです。

string

アイテム ID です。

21926b36-7dd2-4fde-ae25-51b5bc8e****

ProgramId

string

プログラム ID です。この ID は、プログラムアイテムの作成、追加、削除、またはクエリを行う際のリクエストパラメーターとして使用できます。また、この ID を使用して、プログラムの編集、削除、クエリ、開始、または停止も可能です。

16A96B9A-F203-4EC5-8E43-CB92E68X****

RequestId

string

リクエスト ID です。

16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

成功レスポンス

JSONJSON

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

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 MissingParameter %s.
400 InvalidParameter.Malformed There are invalid parameters: %s.
400 IncorrectStartTime %s, please check and try again later.
400 InvalidClientToken.Malformed %s, please check and try again later.
401 IllegalOperation %s, please check and try again later.
500 InternalError %s, please try again later.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。