調用AddCasterEpisodeGroupContent介面添加導播台節目列表內容-ApsaraVideo for Live-阿里雲

介面說明

先建立導播台和添加導播台節目列表，再調用介面添加導播台節目列表資訊。使用 API 建立導播台，請參見建立導播台。

QPS 限制

本介面的單使用者 QPS 限制為 4 次/秒。超過限制，API 呼叫會被限流，這可能會影響您的業務，請合理調用。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

live:AddCasterEpisodeGroupContent

create

*Domain

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

無

請求參數

名稱	類型	必填	描述	樣本值
RegionId	string	否	地區 id。	cn-shanghai
ClientToken	string	是	使用者產生的請求 token。用於保證請求的等冪性。說明由用戶端產生該參數值，要保證在不同請求間唯一，最大值不超過 64 個 ASCII 字元。	8751ad99-2ddb-4aac-ad44-84b21102****
Content	string	是	設定導播台節目屬性。JSON 字串格式。參數採用首字母大寫駝峰格式。屬性資訊說明如下： CallbackUrl：使用者回調地址。 SideOutputUrl：使用者自訂旁路輸出地址。 RepeatNum：重複次數。0 表示不迴圈，-1 表示無限迴圈。 StartTime：起始時間，格式為：yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。 DomainName：網域名稱。 Items：節目列表。 ItemName：節目名稱。 VodUrl：點播檔案地址，若且唯若資源為檔案視頻，且視頻檔案未匯入素材庫時使用，支援 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。可作為建立或添加節目單項，刪除節目單項，查詢節目單項，編輯節目單，刪除節目單，查詢節目單，啟動節目單，停止節目單的請求參數。	16A96B9A-F203-4EC5-8E43-CB92E68X****
RequestId	string	請求 ID。	16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

樣本

正常返回樣本

JSON格式

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

異常返回樣本

JSON格式

{
    "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8",
    "ProgramId": "16A96B9A-F203-4EC5-8E43-CB92E68XX876",
    "ItemIds": [
      "21926b36-7dd2-4fde-ae25-51b5bc8e52d8",
      "21926b36-7dd2-4fde-ae25-51b5bc98765t"
    ]
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊
400	MissingParameter	%s
400	InvalidParameter.Malformed	%s
400	IncorrectStartTime	%s
400	InvalidClientToken.Malformed	%s
401	IllegalOperation	%s
500	InternalError	%s

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。