• Table of Contents
• Previous Next

AddCourse

Specifies a course you want to add to a section in your iTunes U site.

You specify the following entities with the AddCourse operation:

• ParentHandle. Specifies the handle for a section in your iTunes U site where you want to add a course. The parent handle must correspond to an item to which you can add a Course page in your iTunes U site. For example, currently you can only add a Course page to a section. If you do not specify the ParentHandle entity, iTunes U uses the destination string in your URL.

• ParentPath. Specifies the path for a section in your iTunes U site where you want to add a course. The parent path must correspond to an item to which you can add a Course page in your iTunes U site. For example, currently you can only add a Course page to a section. If you do not specify the ParentPath entity, iTunes U uses the destination string in your URL. The ParentPath entity must be in the form “a/b/c” where a, b, and c are folder names. For example, if you have a site named “CupertinoU” containing a section named “Humanities,” you can refer to the ParentPath as <ParentPath>CupertinoU/Humanities</ParentPath> in your AddCourse operation. If specifying the root path, you must start the ParentPath entity with a leading slash (/). To specify a slash (/) as a character within a node of the slash-delimited path, escape the character with a second slash (//).

• TemplateHandle. Specifies the handle of the template you want to use when adding the course. The template handle can correspond to a template or Course page item in your iTunes U site. iTunes U uses the template you specify to provide default values for entities not provided within the Course entity. For example, if you do not specify a course Name entity, iTunes U uses the Name in the specified template.

• Course. Specifies the entities for the course attributes you want to add, including course Name, CourseType, AllowSubscription, ThemeHandle, and Permission. iTunes U adds the new course to the end of the existing courses in the destination section. The web service course Name entity corresponds to the course Title in your iTunes U site.

Notes:

• Specify simple text string values for the Name.

• Specify all details for any Permission (including Credentials and Access) entities.

The following is an example of an iTunes U Web Services document using AddCourse:

<?xml version="1.0" encoding="UTF-8"?>
<ITunesUDocument>
    <Version>1.1.4</Version>
    <AddCourse>
        <ParentHandle>parenthandle value</ParentHandle>
        <ParentPath>parentpath value</ParentPath>
        <TemplateHandle>templatehandle value</TemplateHandle>
        <Course>
           <Name>name value</Name>
           <CourseType>coursetype value</CourseType>
           <ShortName>shortname value</ShortName>
           <Identifier>identifier value</Identifier>
           <Instructor>instructor value</Instructor>
           <Description>description value</Description>
           <Group>
                    <Name>name value</Name>
                    <Handle>handle value</Handle>
                    <Track>
                        <Name>name value</Name>
                        <Handle>handle value</Handle>
                        <Kind>kind value</Kind>
                        <DiscNumber>discnumber value</DiscNumber>
                        <DurationMilliseconds>
                        durationmilliseconds value
                        </DurationMilliseconds>
                        <AlbumName>albumname value</AlbumName>
                        <ArtistName>artistname value</ArtistName>
                        <DownloadURL>downloadurl value</DownloadURL>
                    </Track>
                    <Permission>
                        <Credential>credential value</Credential>
                        <Access>access value</Access>
                    </Permission>
           </Group>
           <AllowSubscription>allowsubscription value</AllowSubscription>
        </Course>
    </AddCourse>
</ITunesUDocument>