• Table of Contents
• Previous Next

AddGroup

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

You specify the following entities with the AddGroup operation:

• ParentHandle. Specifies the handle in your iTunes U site where you want to add a group. The parent handle must correspond to a Course page group item in your iTunes U site.

• ParentPath. Specifies the path in your iTunes U site where you want to add a group. The parent path must correspond to a Course page group item in your iTunes U site. 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,” a course named “Literature,” and a group in that course named “Audio,” you can refer to the GroupPath as <GroupPath>CupertinoU/Humanities/Literature/Audio</GroupPath> in your AddGroup 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 (//).

• Group. Specifies the entities for the group attributes you want to add, including group Name, Handle, GroupType, Permission, Explicit, Track, AllowSubscription, and ExternalFeed. iTunes U adds the new group to the end of the existing groups in the destination course.

Note: If you include the Explicit entity in Group, iTunes U applies the advisory label setting and displays an advisory graphic for the group as appropriate. For example:

• No Explicit entity indicates that the group’s explicitness is unknown. iTunes U does not apply an advisory setting to the group.

• An Explicit entity with a “no” value indicates that the group’s content is not explicit. iTunes U applies the setting, but does not display an advisory graphic for the group. Apple recommends using a “no” value when a group is not explicit but should not have the Clean icon advisory graphic because the group does not contain an alternate version of content from an explicit group ('yes’). Use “no’ to implicitly indicate a group is clean.

• An Explicit entity with a “yes” value indicates that the group is known to contain explicit content, and you want iTunes U to apply an “explicit” setting to the group. iTunes U applies the setting and displays the Explicit icon advisory graphic for the group.

• An Explicit entity with a ‘clean’ value indicates that the group is known to be free of explicit content, and you want iTunes U to apply a “clean” setting to the group. iTunes U applies the setting and displays the Clean icon advisory graphic for the group. Apple recommends that you use ‘clean’ only if the group contains alternate versions of content from an explicit group (“yes”).

iTunes U applies the advisory label setting to any new tracks added to the group and displays an advisory graphic for the group, and all tracks within the group. You can override the setting for specific tracks using “AddTrack” and “MergeTrack.”

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

<?xml version="1.0" encoding="UTF-8"?>
<ITunesUDocument>
    <Version>1.1.4</Version>
    <AddGroup>
        <ParentHandle>parenthandle value</ParentHandle>
        <ParentPath>parentpath value</ParentPath>
        <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>
    </AddGroup>
</ITunesUDocument>