适用版本
Adobe Connect 9.1.
说明
此 API 用于创建研讨会会话。
参数
参数名称 |
类型 |
必需 |
说明 |
|---|---|---|---|
parent-acl-id |
BIGINT |
是 |
创建会话时对应的研讨会 ID。 |
sco-id |
BIGINT |
是 |
研讨会会话 ID。使用此 API 之前，使用 sco-update API 创建研讨会会话 ID。在调用 seminar-session-sco-update 之后调用 acl-field-update API 将负载与研讨会会话 ID 关联。 |
name |
字符串 |
是 |
研讨会会话名称。 |
source-sco-id |
BIGINT |
否 |
需要为其创建会话的研讨会 ID。与 parent-acl-id 相同。 |
date-begin |
日期 |
是 |
会话开始日期。格式示例：2013-08-22T12:58:10.000-07:00。如果研讨会会话的时间与另一研讨会会话重叠，则会导致响应错误，表示存在冲突。 |
date-end |
日期 |
是 |
会话结束日期。格式示例：2013-08-22T12:58:10.000-07:00。如果研讨会会话的时间与另一研讨会会话重叠，则会导致响应错误，表示存在冲突。 |
field-id=seminar-expected-load,value |
字符串 |
否 |
提供该值后，研讨会负载将设为该值。否则，研讨会将设为一般会议（人数 <600）。 |
响应值
元素 |
属性 |
类型 |
说明 |
|---|---|---|---|
sco |
NA |
NA |
有关新会话 sco 的信息。 |
示例请求
以下是结合 sco-update 和 seminar-session-sco-update 创建研讨会会话的流程。
调用 sco-update API 以获取 sco-id（示例）：http://connect-domain-url/api/xml?action=sco-update&account-id=7&folder-id=11101&type=seminarsession&name=b1
注意：folder-id 即为 seminar-id。
上述 API 调用返回的 sco-id 将作为 sco-id 参数传递至 seminar-session-sco-update API 以安排会话。实现该操作的示例调用为 http://connect-domain-url/api/xml?action=seminar-session-sco-update&sco-id=11226&source-sco-id=11101&parent-acl-id=11101&name=fooooo1&date-begin=2013-08-22T15:58:10.000-07:00&date-end=2013-08-22T16:58:10.000-07:00&source-sco-id=11101最后，使用 acl-field-update API 调用来设置 seminar-expected-load 值。示例请求为 http://connect-domain-url/api/xml?action=acl-field-update&acl-id=%3Cseminar-session-sco-id%3E&field-id=311&value=expected-load-in-integer
http://connect-domain-url/api/xml?action=sco-update&account-id=7&folder-id=11101&type=seminarsession&name=b1
http://connect-domain-url/api/xml?action=seminar-session-sco-update&sco-id=11226&source-sco-id=11101&parent-acl-id=11101&name=fooooo1&date-begin=2013-08-22T15:58:10.000-07:00&date-end=2013-08-22T16:58:10.000-07:00&source-sco-id=11101
acl-id 即是使用 sco-update API 创建的会话 ID 或 sco-id。
示例响应
创建会话时 seminar-session-sco-update 的示例响应与设置 seminar-expected-load 值时 acl-field-update 的响应相同，如下所示。<results> <status code="ok"/> </results>
<results> <status code="ok"/> </results>
如果研讨会会话的时间与另一研讨会会话重叠，则会导致响应错误，表示存在冲突。
