• Table of Contents
• Previous Next

AddSection

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

You specify the following entities with the AddSection operation:

• ParentHandle. Specifies the handle in your iTunes U site where you want to add a section. The parent handle must correspond to the root or a division item in your iTunes U site. If the handle does not match an existing item, iTunes U returns an error message. If you do not specify the ParentHandle entity, iTunes U uses the destination string in your URL.

• ParentPath. Specifies the path in your iTunes U site where you want to add a section. The parent path must correspond to the root or a division item in your iTunes U site. If the path does not match an existing item, or matches multiple items, iTunes U returns an error message. 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 division named “Fall07,” you can refer to the ParentPath as <ParentPath>CupertinoU/Fall07</ParentPath> in your AddSection 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 (//).

• Section. Specifies the entities for the section attributes you want to add, including section Name, Handle, and Course.

Notes:

• Specify simple text string values for the Name entity.

• To specify whether or not users can subscribe to a specific section as a podcast, you can specify the following values for AllowSubscription: true, false. You can use this entity to override your global track preferences setting on a per-section basis.

• Specify all details for any Group (including Name) or Permission (including Credential and Access) entities.

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

<?xml version="1.0" encoding="UTF-8"?>
<ITunesUDocument>
    <Version>1.1.4</Version>
    <AddSection>
        <ParentHandle>parenthandle value</ParentHandle>
        <ParentPath>parentpath value</ParentPath>
        <Section>
            <Name>name value</Name>
            <Handle>handle value</Handle>
            <Course>
                <Name>name value</Name>
                <CourseType>coursetype value</CourseType>
                <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>
            </Course>
        </Section>
    </AddSection>
</ITunesUDocument>