ITunes U Web Services -- AddCourse

I'm looking to use the AddCourse web service, has anyone else successfully used this feature of the iTunes U Web Service (with Java / Perl)?

Dave from Arizona State has created a set of Java wrappers for the web services API. I haven't tried 'em, but I bet they are really, really cool.
http://discussions.apple.com/thread.jspa?messageID=5417581&#5417581
Remember to give Dave the points if the API works the way you need it to do.

Similar Messages

How to Specify Metadata When Adding Content Using iTunes U Web Service?

I've been developing Java applications using iTunes U Web service and uploaded content to iTunes U site using iTunes U Web service without problem. Now I want to add metadata fields (name, artist name, album name, etc.) for the tracks I uploaded. It seems to me that "AddTrack" will do. So I tested it but it neither adds a track under the specified group nor updates metadata fields for an existing track. It turned out "MergeTrack" actually updates metadata fields for an existing track. So is there any way to specify metadata at the time of adding content using iTunes U Web service? And what exactly does AddTrack do? This is all about contents hosted by iTunes U site and no RSS is involved.
I'm referring to the "AddTrack" method in iTunes U Web service:
http://deimos.apple.com/rsrc/doc/iTunesUAdministrationGuide/iTunesUWebServices/c hapter18_section_21.html#//appleref/doc/uid/AdminGuide-CH13-SW26

Thanks for all the replies. My question is whether there is any way to specify metadata WHEN adding content using iTunes U Web service. Specifying metadata AFTER adding content can be achieved by MergeTrack (weird naming) and it does work.
As for setting track level meta-data in the media file and then upload it, there're several reasons against that, among which are:
1. Some track metadata are context-dependent. A video about buildings on Michigan Ave in Chicago can be track #2 in a history course and described as "historic view of the Magnificent Mile", but the same media can also be track #5 in a landscape design course and described as something like "contemporary architecture". Setting these metadata in the media file itself is not the preferred way to do it since it implies maintaining a version of the same media for any course/group it gets uploaded to.
2. Setting metadata in a location separate from the media file helps track the metadata change and search for media without digging into the media itself.
3. If MergeTrack "updates" metadata, there got to be some other method that "creates" metadata - that's what a well-designed API should look like. And setting metadata in the media file is not an equivalent to a "create metadata" method call. In rickwolf's term, that implicit AddTrack should actually be made explicit so the party uploading content can explicitly specify metadata instead of having iTunes U extract metadata from the media.
It is still not clear what "AddTrack" does exactly, maybe rickwolf is right - it's only relevant to tracks created through RSS.
So it seems to me there is no other way to specify metadata WHEN adding content using iTunes U Web service than setting metadata in the media file. To me it is more like a design flaw.
Message was edited by: Stone Xiang
Message was edited by: Stone Xiang
Message was edited by: Stone Xiang

Have the web service API URLs changed?

I'm currently in the beginning stages of working with the iTunes U Web Service API, and I'm running into an issue.
Step 2 of uploading a web services document (pg 50 of the admin guide) says to request an upload URL. The base URL for this request:
https://deimos.apple.com/WebObjects/Core.woa/API/GetUploadURL
doesn't seem to be valid. I am receiving 404 errors:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>404 Not Found</title>
<meta name="generator" content="Indigo">
</head>
<body>
Not Found
The requested URL /WebObjects/Core.woa/API/GetUploadURL was not found on this server.
</body>
</html>
I've tried added the identifier path but still no luck. Just to be clear, I am generating and sending a proper authorization token; the issue is that the destination URL seems to be invalid.
Have the API URLs changed or am I missing something?
Thanks

Hi Chris,
A couple of things ...
First is that you want to read page 54 of latest admin guide.
Nextly, the basic way to access the API hasn't changed ... Apple has changed the XSD and the specifics of the API itself ... but not the way you call it. That's been pretty steady since I've been messing with it.
The base URL should look like this:
https://deimos.apple.com/WebObjects/Core.woa/API/GetUploadURL/your-university.ed u.111.222.333
"111.222.333" is called a "handle" and it uniquely specifies a resource (track, cover image, etc.) within iTunes U. "111.222" is a path to the resource "333".
After the base URL, you have to add the same kind of token string that you would for "Browsing" iTunes U ... that is a string in the form ...
credentials=foo&identity=user&time=123456&signature =abc123abc&type=XMLControlFile
A question mark "?" separates the base URL from the token string. Whatever you do, do -not- forget the type=XMLControlFile! The manual does not emphasize that you need to add this token, but you must to use the API.

Python Web Services Implementation?

Has there been any python implementations of the iTunes U Web Services? I was checking out rtunesu ( http://wonderfullyflawed.com/2008/09/12/itunes-u-via-ruby/ ) and was curious if any python equivalent has been developed.
Thanks!

Hi Jason,
There's a little more to it than that I'm afraid.
To upload a file to Apple (either XML or audio/video/PDF content), you have to POST a multipart MIME form. What you have will POST, but what you're missing is the multipart MIME.
This is an example of the kind of thing you need to do:
http://code.activestate.com/recipes/146306/

"File Not Found" when addCourse through iTunesU web service.

I have problem to add Course to my institute's iTunesU site through Web Service.
I was able to get the xml doc back through showTree operation and here is part of it:
<Site>
<Name>my institute's name</Name>
<Handle>123</Handle>
<AggregateFileSize>63057465318</AggregateFileSize>
<Section> <Name>Your Classes</Name>
<Handle>456</Handle>
<AggregateFileSize>57423912007</AggregateFileSize>
<Course>
<Name>course 1</Name>
<Handle>111</Handle>
</Course>
</Section>
<Section>
I was able to get the uploadURL back too. The URL to get the uploadURL request:
https://deimos.apple.com/WebObjects/Core.woa/API/GetUploadURL/myInstitute.edu.45 6?type=XMLControlFile
The uploadURL I got back looks like:
https://deimos2.apple.com/WebObjects/Files.woa/Upload/myInstitute.edu.456/X_1371095208_1a.43c06fa3.467dc4f2/%5Banonymous1371095208%5D/0046e71254900a071aa9241221a469d98ff1ef6fa973544c45ef9 5260dac6c64f05b10aefc
But when I use the uploadURL above and post the addCourse.xml:
<ITunesUDocument>
<AddCourse>
<ParentHandle>456</ParentHandle>
<Course>
<Name>Jing Test iTunesU Web service Course</Name>
<ShortName>Jing Test</ShortName>
</Course>
</AddCourse>
</ITunesUDocument>
The response I got
<error>File Not Found</error> File Not Found
I used myInstitute.edu.456 to get the uploadURL and set it to ParentHandle on addCourse.xml since 456 is the section handler in whoch I want to add the course.
I tried to remove 456 from the myInstitute.edu to get the uploadURL and then use it to add course, got the same error.
Is there something wrong with the URL I used to get the uploadURL?
here is the code and the values pass to the methodI used to send addCourse request:
url = uploadURl on above
name="file"
fileName="file.xml";
data=addCourse xml on above
contentType="text/xml"
public String invokeAction(String url,
String name,
String fileName,
String data,
String contentType) throws MessagingException {
// Send a request to iTunes U and record the response.
StringBuffer response = null;
System.out.println("xml doc: ---" + data);
try {
// Verify that the communication will be over SSL.
if (!url.startsWith("https")) {
throw new MalformedURLException("ITunesUFilePOST.invokeAction(): URL \""
+ url + "\" does not use HTTPS.");
// Build the multipart data.
MimeMultipart multipart = new MimeMultipart();
MultipartFormBuilder.addMultipartFormBody(multipart,
name,
fileName,
data,
contentType);
// Create a connection to the requested iTunes U URL.
HttpURLConnection connection =
(HttpURLConnection) new URL(url).openConnection();
connection.setUseCaches(false);
connection.setDoOutput(true);
connection.setRequestMethod("POST");
connection.setRequestProperty("Content-Type",
"multipart/form-data; boundary="
+ MultipartFormBuilder.getMultipartBoundary(multipart));
String multipartData = MultipartFormBuilder.getMultipartData(multipart);
// Send the multipart data to iTunes U.
connection.connect();
OutputStream output = connection.getOutputStream();
output.write(multipartData.getBytes("UTF-8"));
output.flush();
output.close();
// Read iTunes U's response.
response = new StringBuffer();
InputStream input = connection.getInputStream();
Reader reader = new InputStreamReader(input, "UTF-8");
reader = new BufferedReader(reader);
char[] buffer = new char[16 * 1024];
for (int n = 0; n >= 0;) {
n = reader.read(buffer, 0, buffer.length);
if (n > 0) response.append(buffer, 0, n);
// Clean up.
input.close();
connection.disconnect();
} catch (UnsupportedEncodingException e) {
// ITunes U requires UTF-8 and ASCII encoding support.
throw new java.lang.AssertionError("ITunesUFilePOST.invokeAction(): UTF-8 encoding not supported!");
} catch (IOException e) {
// Report communication problems.
throw new java.lang.AssertionError("ITunesUFilePOST.invokeAction(): I/O Exception " + e);
// Return the response received from iTunes U.
System.out.println("response from ITunesUFilePOST: " + response.toString());
return response.toString();
}

I'm having a similar "File Not Found" error, but it's happening for any API request other than GetUploadURL. I'm sending a POST request to the GetUploadURL, and that part is working correctly, as I get a URL such as the following:
https://deimos2.apple.com/WebObjects/Files.woa/Upload/wvu.edu/X_1372071795_4d9433be.4c3fdd3d.4c3fdd3e/%22Chris%20Scharf%22%20%3Ccbscharf%40mail.wvu.edu%3E%20%28cbscharf%29%20%5B3258 7%5D/0046eaaaf078cf5d6b60f18926106a50a5050cf8f9c91a7608074e6d2949a8759017969ece
Then, I've tried using curl (within 90 seconds) to submit a simple XML document containing a ShowTree request:
<?xml version="1.0" encoding="UTF-8"?>
<ITunesUDocument>
<ShowTree>
<KeyGroup>most</KeyGroup>
</ShowTree>
</ITunesUDocument>
The command executed is "curl -F file=test.xml URL" (where URL is the URL retrieved from GetUploadURL. But I simply get "<error>File Not Found</error>"
I'm correctly sending credentials, since I'm getting upload URLs. And it's not an issue with the XML document, since it's not even getting to the server.

ITunes App Store Web Service available?

Hi there,
appshopper.com has great lists and rankings about iPhone apps in the App Store. Does anybody happen to know which interface the folks at appshopper use? I am not aware of any official interface (and I don't believe, they do it all manually...).
Hints are welcome.
-Ralf

Apple doesn't publish a web service interface to the App Store. However the iTunes Music (and App) Store is simply a web app and you can actually access iTunes URLs from outside of iTunes.
There are many examples on the Internet of scripts and programs that scrape information from iTMS for various purposes. Search for "iTunes scrape" and you will find some.

My mom helped me to create my iTunes account and load it with a 50$ gift card and now I wanted to purchase a one month subscription at the AYI dating web service but apple never let them take money from my account and I was declined,don't know why?

My mom helped me to create my iTunes account and load it with a 50$ gift card and now I wanted to purchase a one month subscription at the AYI dating web service but apple never let them take money from my account and I was declined,don't know why?

You have posted to the iTunes Match forum, which your question is not related to. I suggest you contact the web site from whom you wish to purchase the subscription.

Web-services.xml

I'm implementing WS-SECURITY for my web service. The only service that I am enabling is the soap encryption. Furthermore, I only want to encrypt the request. I in the web-services.xml the operations specify the security spec to use for both the request and the response...
in-security-spec
out-security-spec
The docs say "If you do not specify this attribute, the default security specification, if it exists, is applied to the SOAP response. If there is no default security specification, then no message-level security is applied to the SOAP response."
My question is how do you disable the response if there is a default security spec.
thx

xmllint is correct. Here's what the 1.1.3 XSD says (I put in the leading periods to fool the discussion board into preserving structure ):
. <xsd:element name="ITunesUDocument">
. . <xsd:complexType>
. . . <xsd:sequence>
. . . . <xsd:element ref="Version" minOccurs="1" maxOccurs="1"/>
. . . . <xsd:element ref="AddCourse" minOccurs="0"/>
. . . </xsd:sequence>
. . </xsd:complexType>
. </xsd:element>
If "minOccurs" or "maxOccurs" aren't specified in sequence elements, then they both default to "1". So the "minOccurs" and "maxOccurs" specifiers are redundant in the "Version" element specification…they'd be "1" anyway. Setting "minOccurs" to "0" means that you can omit the element in XML…but unless "maxOccurs" is set, than the most any element can appear in the sequence is once to be valid. "unbounded" can be used in "maxOccurs" to set no limit on the number of times it can appear in the sequence.
Recall that XML doesn't necessarily have to validate to "work". An XML validation is a contract between us and Apple…Apple promises that we can put at least one "AddCourse" in an "ITunesUDocument" and that is going to work, or our money back. But if we don't submit valid XML, it might still work…but there is no promise there either. It might work today, it might fail tomorrow. The iTunes U people have said, in various venues, that we should expect Apple to validate our XML…but nobody's perfect. It could be that Apple just missed this one…but we should still write code under the assumption that the XSD is being correctly applied and that our XML is being validated on Apple's end. That way, our code can never be "wrong".

Web Services validation before provisioning request completes...

Hi All,
We are working on Web Services validation before provisioning request completes to see if there are duplicated in target database. Is this possible?
We want to check in target database for value if exists prior to provisioning the request and fail the provisioning process if the value is duplicate.
For Eg:
Input with ApplnID:5221 while provisioning and check in target database if ApplnID:5221 exists and then to continue provision.
This is similar to what we are executing in our development environment.
Can you please suggest any idea if you have worked on this earlier
Thanks,
Subbu

xmllint is correct. Here's what the 1.1.3 XSD says (I put in the leading periods to fool the discussion board into preserving structure ):
. <xsd:element name="ITunesUDocument">
. . <xsd:complexType>
. . . <xsd:sequence>
. . . . <xsd:element ref="Version" minOccurs="1" maxOccurs="1"/>
. . . . <xsd:element ref="AddCourse" minOccurs="0"/>
. . . </xsd:sequence>
. . </xsd:complexType>
. </xsd:element>
If "minOccurs" or "maxOccurs" aren't specified in sequence elements, then they both default to "1". So the "minOccurs" and "maxOccurs" specifiers are redundant in the "Version" element specification…they'd be "1" anyway. Setting "minOccurs" to "0" means that you can omit the element in XML…but unless "maxOccurs" is set, than the most any element can appear in the sequence is once to be valid. "unbounded" can be used in "maxOccurs" to set no limit on the number of times it can appear in the sequence.
Recall that XML doesn't necessarily have to validate to "work". An XML validation is a contract between us and Apple…Apple promises that we can put at least one "AddCourse" in an "ITunesUDocument" and that is going to work, or our money back. But if we don't submit valid XML, it might still work…but there is no promise there either. It might work today, it might fail tomorrow. The iTunes U people have said, in various venues, that we should expect Apple to validate our XML…but nobody's perfect. It could be that Apple just missed this one…but we should still write code under the assumption that the XSD is being correctly applied and that our XML is being validated on Apple's end. That way, our code can never be "wrong".

"Unknown error" when adding a page via web services

I am trying to add a division (a Welcome page) to a section on another welcome page, in order to get a site structure that is one level deeper than what can be built using the iTunes interface. I am using Web Services, which is new to me, to try to do this, as I understand that web services allows this (see http://discussions.apple.com/thread.jspa?messageID=6786261&#6786261). I have build a login page that takes my institutional name and password, authenticates me, constructs the authorization token, requests, and successfully receives an upload URL from iTunes U.
It sets the action on a file upload form to this received URL. I then, easily within 90 seconds, browse to the Web Services XML file I want to upload, select it in the file upload form field, and submit the form.
Despite several change to my Web Services document, the text "Unknown error" is all I ever receive back, and my division is not added. Can anyone help?
An the HTML output of the dynamically constructed page with the upload form, and the web services document I am trying to upload, may be found at:
http://itc.boisestate.edu/iTunesU.zip
Thanks,
Eric Orton

It's probably due to the unescaped ampersand in your division name. To be well-formed XML, it must be written as "&" (and, 'a', 'm', 'p', semicolon). In addition, the order of your parameters does not match the XSD. Here's a version that does:
<ITunesUDocument>
<Version>1.1</Version>
<AddDivision>
<ParentHandle>1525601603</ParentHandle>
<ParentPath/>
<TemplateHandle>1525143263</TemplateHandle>
<Division>
<Name>Modern Languages & Literature</Name>
<ShortName>Modern Languages</ShortName>
<Identifier>langlit</Identifier>
<AllowSubscription>true</AllowSubscription>
<Permission>
<Credential>Authenticated@urn:mace:itunesu.com:sites:boisestate.edu</Credential>
<Access>No Access</Access>
</Permission>
</Division>
</AddDivision>
</ITunesUDocument>

How to use ComplexType in Web Services with Jdeveloper

I've look an article which says:
If the parameter is created as a JavaBean that implements the java.io.Serializable interface and exposes all of its properties using the accessor style of getX and setX, Oracle Application Server will handle the XML serialization and deserialization automatically.
but when I use jdeveloper to create a web Service it only comes up with the warning:
Method addCourse:the following parameter types do not have an XML Schema mapping and/or serializer specified:
mypackage.CourseJavaBean
my code is:
package whut.mypackage;
import java.io.Serializable;
public class CourseJavaBean implements Serializable

Hi Dugu,
Can you give the link to the specific article and the version of JDeveloper you are using to help you further?
One thing to keep in mind is that the accessors must be public - using package access (no modifier) is not going to work.
Hope this helps,
Eric

Correction for Daily Report Log Web Service

In the August 29th iTunes U Administrator email, there was a mistake in the example for the Daily Report Log Web Service.
The example showed:
http://deimos.apple.com/WebObjects/Core.woa/API/GetDailyReportLogs/example.edu?S tartDate=2007-07-01&EndDate=2007-07-17&destination=example.edu&username=ADMIN&ac cesskeys=Administrator@urn:mace:itunesu.com:sites:example.edu&emailaddress=foo@b ar.com&displayname=test&expiration=1186086577&signature=4443ac48a8ae1a0c50dbfb35 f201b6d0db14b16d
There are extraneous form value pairs in the above example. The POST form values required to get a daily report are:
StartDate (EndDate is optional) - format YYYY-MM-DD
credentials
identity
signature
An example of a correct request:
http://deimos.apple.com/WebObjects/Core.woa/API/GetDailyReportLogs/example.edu?S tartDate=2007-09-12&EndDate=2007-09-13&credentials=Administrator@urn:mace:itunes u.com:sites:example.edu&identity=%22JaneDoe%22+%3Cjdoe%40example.edu%3E+%28jdoe%29%5B42%5D&signature=38bda70d9aa6975ae8756754034feb6e3c794aca4b21665f6dc85d2ed42d4 f6b

Currently displaying audit log reports in REST or API is not supported by Microsoft. SharePoint online in Office 365 just supports saving an audit log report as a Microsoft Excel 2012 Preview workbook.
You can refer the following post :
http://community.office365.com/en-us/f/172/t/164047.aspx

Is there a WSDL for this Web Service

I am new to this Web Service Toolkit and am wondering if there is a WSDL for it. If so an example URL would be great.

If you're here asking about the Mac OS X Server Podcast Producer, that's part of Mac OS X Server, and Mac OS X Server is a feature-upgrade to, and does cost more than, the more familiar Mac OS X (client) software package. You'll also need sufficient network bandwidth for whatever you're planning here, particularly if you're going to be distributing this podcast material directly from your Mac OS X Server box.
If you're here asking about creating podcasts using Garageband or other tools, then yes, there can be fees associated with those products. Garageband is part of the iLife tools, and a version of that is installed with new Mac systems, though upgrades do cost money. (And get yourself a good external cartioid condensor or equivalent microphone; the audio quality from the built-in mikes is very poor.)
If you're here asking about the podcast downloads using iTunes and accessing the Apple servers for the podcasts you can download - and specifically about publishing the podcasts - then I believe those are free (at least for non-commercial podcasts), but you'll want to check the iTunes Making a Podcast document for details
If I've not guessed at your particular goal(s) here (your question is unfortunately somewhat ambiguous), please consider providing a little more background on what you're up to and what problem(s) you're solving.

Permissions Web Service Requests

Okay, I'm moving from "Groups" to "Permissions".
This post is just an FYI…not sure it's a bug or a feature…or even a little bit of both at the same time.
In the "Permissions" web service requests (AddPermission, etc.) if you do not specify either a ParentHandle or ParentPath, the web service request is applied to your site root. You can still use a single forward slash as ParentPath for "root"…it has the same effect as leaving ParentPath and ParentHandle empty.
If I recall correctly, most requests that take either a handle or path will return an error if neither is specified. I think this may be one of a small subset of requests that assumes "root" if both are missing.

More notes on permissions…again, I think things work as intended, but I thought I'd mention this tidbit in the event that it might be useful to others.
MergePermission can only work with an existing permission (access-level/credential pair)…this is as expected. If you try to "merge" a permission for a credential which does not exist, or if you do not specify a credential, you get an error saying that MergePermission cannot find the target credential. In effect, MergePermission changes the access-level for any permission it can find by-way-of an existing credential.
Similarly, you cannot ask MergePermission to change the form of a credential. For example, you cannot use MergePermission to "change the credential whose associated access-level is 'Download' from 'Test@urn:mace…' to 'Student@urn:mace…'." MergePermission must always find that a target credential exists.
However, when dealing with an existing permission, there is no effective difference between AddPermission and MergePermission. That is, if you add a permission whose credential already exits, then you overwrite it as-if you had merged it. Again, this works as expected. A "student", say, cannot have both "Downlaod" and "No Access" within the same iTunes U page. The only warning I would give is that AddPermission can act destructively…you are not warned, when using it, that if the permission you wish to add corresponds to a permission which already exists, then that permission will be overwritten.

Can't find where to update SOAP header request on a Web Service

Hello,
I am consuming a certain Web Service from a remote Server and succefully created a client proxy for it.
This Web Service requires a String parameter (which is the licence key) to be inserted in the SOAP request header. I've searched at the client proxy I created under Virtual Interface, Web Service Definition and under Web Service Configuration but couldn't find an option which allows me to modify the SOAP header request.
At this link:
http://help.sap.com/saphelp_nw04/helpdata/EN/a2/99af4e693dee43a0519e029549647b/content.htm
There is an explanation on how to transfer existing request parameters from the SOAP body to the SOAP header, but I want to add the header new parameter except the exsiting parameters the Web Service request expects.
I can of course write the request myself but than I loose the whole wizard advantage...
Can someone please tell me where can I find it?
Roy

Ralph Landry1, your link just sends them to the links I provided.
If you have an iPod touch:
For Windows: See iPhone, iPad, or iPod touch: Device not recognized in iTunes for Windows
For Mac OS X: See iPhone, iPad, iPod touch: Device not recognized in iTunes for Mac OS X

ITunes U Web Services -- AddCourse

Similar Messages

Maybe you are looking for