• Table of Contents
• Previous Next

AddDivision

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

You specify the following entities with the AddDivision operation:

• ParentHandle. Specifies the handle in your iTunes U site where you want to add a division. The parent handle must correspond to a section item in your iTunes U site root. 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 division. The parent path must correspond to a section item in your iTunes U site root. 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 section named “Humanities,” you can refer to the ParentPath as <ParentPath>CupertinoU/Humanities</ParentPath> in your AddDivision 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 division. The template handle can correspond to a template or page item in your iTunes U site. iTunes U uses the template you specify to provide default values for entities not provided within the Division entity. For example, if you do not specify a division Name entity, iTunes U uses the Name in the specified template.

• Division. Specifies the entities for the division attributes you want to add, including division Name, ShortName, Identifier, AllowSubscription, Permission, Section, ThemeHandle, and Description.

Notes:

• Specify simple text string values for the Name, Shortname, and Identifier entities.

• To specify whether or not users can subscribe to a specific division 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-division 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 AddDivision:

<?xml version="1.0" encoding="UTF-8"?>
<ITunesUDocument>
    <Version>1.1.4</Version>
    <AddDivision>
        <ParentHandle>parenthandle value</ParentHandle>
        <ParentPath>parentpath value</ParentPath>
        <Division>
            <Name>name value</Name>
            <ShortName>shortname value</ShortName>
            <Identifier>identifier value</Identifier>
            <AllowSubscription>allowsubscription value</AllowSubscription>
            <Permission>
                <Credential>credential value</Credential>
                <Access>access value</Access>
            </Permission>
            <Section>
                <Name>name value</Name>
                <Handle>handle value</Handle>
                <Course>
                    <Name>name value</Name>
                </Course>
            </Section>
            <ThemeHandle>themehandle value</ThemeHandle>
        </Division>
    </AddDivision>
</ITunesUDocument>