asset-interaction-response-update

To add registration questions to an Event using API, use asset-interaction-response-update Web Service API.

Availability

Adobe Connect 9.5.4

Description

Add registration questions to en Event using this API.

Request URL

http://server_name/api/xml?action=asset-interaction-response-update
&interaction-type=string
&asset-type=string
&is-required=boolean
&sco-id=integer
&csvResponse=string
&csvChoicesEnabled=boolean
&description=string
&response-display-seq=integer&response-description=string
&response-display-seq=integer&response-description=string
&response-display-seq=integer&response-description=string
&session=BreezeSessionCookieValue

Parameters

Name

Type

Required

Description

sco-id

Integer

Yes

Sco ID of an event

asset-type

String

Yes

Type of asset data (currently only accepts type output)

interaction-type

String

Yes

Type of a question:

  • choice=Multiple Choice
  • fill-in=Short Answer
  • true-false =Yes/No

is-required

Boolean

Yes

Indicates whether answering a question is mandatory or not. True means required otherwise the question can be skipped.

description

String

Yes

Description of a question.

csvChoicesEnabled

Boolean

No

The parameter applies only in the case of multiple choice questions. True means answers are in comma separated format.

csvResponse

String

No

The parameter applies when csvChoicesEnabled is true and contains the list of answers in comma separated format.

response-display-seq=string&response-description=string

String

No

This parameter applies only in the case of multiple-choice question. It is used to list all the answers applicable to a question.

response-display-seq indicates sequence of answer in the list of answers.

response-description contains answer of a question It is recommended to use a CSV to create question.

session

 

No

The value of the BREEZESESSION cookie. Use this parameter if you do not use a client-side cookie management library.

Filters

Results cannot be filtered or sorted.

Response or return structure

<results>
    <status code="ok"/>
    <asset-interaction interaction-type="choice" is-required="true" asset-id="12573" display-seq="1" interaction-id="13101">
        <description>California</description>
        <name>Interaction_obckfghghh</name>
    </asset-interaction>
</results>

Sample requests and sample responses

The following API call creates a multiple choice question with answers.

http://www.example.com/api/xml?action=asset-interaction-response-update&csvChoicesEnabled=false&response-display-seq=2&response-description=USA&asset-type=output&response-display-seq=1&response-description=North California&csvResponse=&response-description=North California&interaction-type=choice&response-display-seq=3&response-description=California&response=%20&response-counter=1&is-required=true&description=Where is San Diego&sco-id=12542&response-display-seq=1

The sample response of the multiple choice question creationAPI call is

<results>
    <status code="ok"/>
    <asset-interaction interaction-type="choice" is-required="true" asset-id="15227" display-seq="3" interaction-id="20545">
        <description>South California</description>
        <name>Interaction_evv3gda8fy</name>
    </asset-interaction>
</results>

The following API call creates a question with answers in the comma separated format.

http://www.example.com/api/xml?action=asset-interaction-response-update&interaction-type=choice&csvChoicesEnabled=true&asset-type=output&is-required=true&description=Where%20is%20San%20Francisco?&csvResponse=California,%20USA,%20North%20California&sco-id=12542&response=%20&response-description=

The sample response of the preceding API call is

<results>
    <status code="ok"/>
    <asset-interaction interaction-type="choice" is-required="true" asset-id="15227" display-seq="3" interaction-id="20544">
        <description>South California</description>
        <name>Interaction_uxw2asgdz6</name>
    </asset-interaction>
</results>

The following API call creates a question that needs a short answer.

http://example.com/api/xml?action=asset-interaction-response-update&sco-id=15201&interaction-type=fill-in&asset-type=output&description=Describe Adobe in 5 words?&input-data-type=text-interaction&is-required=true

The sample response of the short answer creation API call is

<results>
<results>
    <status code="ok"/>
    <asset-interaction interaction-type="fill-in" input-data-type="text-interaction" is-required="true" interaction-id="20546" asset-id="15227" display-seq="3">
        <description>Describe Adobe in 5 words?</description>
        <name>Interaction_x32nvabcuk</name>
    </asset-interaction>
</results>

The following API call creates a question that needs a Yes or No answer.

http://example.com/api/xml?action=asset-interaction-response-update&sco-id=15201&asset-type=output&interaction-type=true-false&description=Does the sun rise in the west?&is-required=true

A sample response of the Boolean question creation API call is

<results>
    <status code="ok"/>
    <asset-interaction interaction-type="true-false" is-required="true" interaction-id="20548" asset-id="15227" display-seq="4">
        <description>Does the sun rise in the west?</description>
        <name>Interaction_d8fzowweh8</name>
    </asset-interaction>
</results>

Response or return values

Element

Attribute

Type

Description

results

 

Container

All the results that are returned by the call.

status

 

Empty, with attributes

The status of the response.

 

code

Allowed value

A code indicating the response status (see status).

asset-interaction

 

Container

Contains information about the interaction. Multiple interactions can be part of the SCO.

 

interaction-id

Integer

The ID of the interaction.

 

asset-id

Integer

The ID of the asset associated with the event. The asset-id changes when you add or update a new content version.

 

display-seq

Integer

The sequence number of the interactions assigned to the SCO.

 

input-data-type

String

Data type for the interaction.

 

interaction-type

String

Type of the method used for interaction, choice for multiple choice question, tracking-id for campaign tracking, and so on.

 

is-required

Boolean

Flag indicating whether the interaction is required or not. The value True indicates that the interaction is required.

 

source-interaction-id

Integer

The source of an interaction.

 

description

String

The description of the question.

 

name

String

The name of the question.

Get help faster and easier

New user?