AddCasterProgram - ApsaraVideo Live - Alibaba Cloud ドキュメントセンター

使用状況ノート

この操作は、CreateCaster操作を呼び出すときにNormTypeが0 (プレイリストモード) に設定されているプロダクションスタジオにのみ適用されます。

QPS制限

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

デバッグ

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

リクエストパラメーター


パラメーター	データ型	必須／任意	例	説明
操作	String	必須	AddCasterProgram	実行したい操作。値をAddCasterProgramに設定します。
CasterId	String	必須	3463f576-ff9e-4807-be32-b95d5bad ****	制作スタジオのID。 CreateCaster 操作を呼び出したときの応答に含まれます。
RegionId	String	任意	cn-shanghai	リージョンの ID
エピソードN.EpisodeType	String	任意	リソース	エピソードNのタイプ。 Resource: ビデオリソース。 Component: コンポーネント。
Episode.N.EpisodeName	String	任意	program_name_1	エピソードNの名前。
エピソード. N.ResourceId	String	任意	a2b8e671-2fe5-4642-a2ec-bf93880e ****	ビデオリソースのID。このパラメーターは有効で、Episode.N.EpisodeTypeパラメーターがResourceに設定されている場合にのみ必要です。 Episode.N.EpisodeTypeパラメーターがComponentに設定されている場合、このパラメーターは無効です。
エピソード. N.ComponentId.N	RepeatList	任意	["a2b8e671-2fe5-4642-a2ec-bf931826 **" 、"a2b8e671-2fe5-4642-a2ec-28374657 **"]	コンポーネントNのID。制作スタジオのコンポーネントは、配列の下から上にリストされます。このパラメーターは有効で、Episode.N.EpisodeTypeパラメーターがComponentに設定されている場合に必要です。 Episode.N.EpisodeTypeパラメーターがResourceに設定されている場合、このパラメーターはオプションです。この場合、このパラメーターを指定すると、コンポーネントはビデオリソースとバインドされ、一緒に切り替えられます。
エピソードN.StartTime	String	任意	2016-06-29T09:00:00Z	エピソードNが始まる時間。 ISO 8601標準のyyyy-MM-dd T HH:mm:ss Z形式で時刻を指定します。時刻はUTCである必要があります。
エピソード. N.EndTime	String	任意	2016-06-29T10:02:00Z	エピソードNが終了する時間。 ISO 8601標準のyyyy-MM-dd T HH:mm:ss Z形式で時刻を指定します。時刻はUTCである必要があります。
エピソード. N.SwitchType	String	任意	TimeFirst	エピソードを切り替えるためのポリシー。設定可能な値は以下のとおりです。 TimeFirst: エピソードは前のエピソードの終了時に開始し、次のエピソードの開始時に終了します。次のエピソードが存在しない場合、新しいエピソードが追加されるか、制作スタジオが停止するまで、エピソードは繰り返し続けます。ビデオリソースがライブストリームの場合、このパラメーターはTimeFirstに設定する必要があります。 ContentFirst: エピソードは予定通りに開始および終了します。このパラメーターは、Episode.N.EpisodeTypeパラメーターがResourceに設定されている場合にのみ有効になります。

注

リクエストパラメータ名の変数Nは、エピソードのシーケンス番号を示します。例：

Episode.N.EpisodeNameパラメーターは、エピソードNの名前を指定します。Episode.1.EpisodeNameパラメーターは、最初のエピソードの名前を指定します。 Episode.2.EpisodeNameパラメーターは、2番目のエピソードの名前を指定します。

レスポンスパラメーター


パラメーター	データ型	例	説明
EpisodeIds	EpisodeIdの配列		追加されたエピソードのID。エピソードIDは、変数Nによって指定されるのと同じ順序でリストされる。
EpisodeId
EpisodeId	String	["16A96B9A-F203-4EC5-8E43-CB92E68F **", "16A96B9A-F203-4EC5-8E43-CB92E688 **"]	エピソードのID。追加されるエピソードの管理に使用できるIDを記録します。
RequestId	String	16A96B9A-F203-4EC5-8E43-CB92E68F4CD8	リクエストの ID です。

例

リクエストの例

http(s):// live.aliyuncs.com/?Action=AddCasterProgram
&CasterId=a2b3463f576-ff9e-4807-be32-b95d5bad ****
&<共通リクエストパラメーター>

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

XML 形式

<AddCasterProgramResponse>
  <EpisodeIds>
        <EpisodeId>
              <EpisodeId>["bb9f1234-40fa-48c3-ac7a-e2e132c9 ****"]</EpisodeId>
        </EpisodeId>
  </EpisodeIds>
  <RequestId>44A7CD26-FFAF-4964-BF38-B3567C2C431A</RequestId>
</AddCasterProgramResponse>

JSON 形式

{
    "EpisodeIds": {
        "EpisodeId": [
            {
                "EpisodeId": ["bb9f1234-40fa-48c3-ac7a-e2e132c9 ****"]
            }
        ]
    },
    "RequestId": "44A7CD26-FFAF-4964-BF38-B3567C2C431A"
}

エラーコード

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