Using iTunes U Private Sites: Requesting Daily iTunes U Log Reports

Next Previous

Requesting Daily iTunes U Log Reports

To receive daily reporting information from your iTunes U site, you can use the GetDailyReportLogs API to request an iTunes U log report in raw text file format.

To use the GetDailyReportLogs API, you must update your existing transfer script to optionally return just the authorization token instead of redirecting to a URL. To do this, you can either create a new script or pass an argument to your existing script.

To request a daily log report:

Generate an authorization token from your new or updated transfer script. For details, see “Generating the Token Data.”
Invoke a GET, using the authorization token from step 1, to the GetDailyReportLogs API, including a StartDate (required) and EndDate (optional) formatted as YYYY-MM-DD. iTunes U returns an error if the date is outside the range of data that has been processed for your site.

Notes:

iTunes U returns only the last 60 days of report logs.
Only site administrators can request daily reporting information using GetDailyReportLogs. Be sure to send your administrator credential along with the request.
A day’s log report is typically complete or near complete the morning of the second day, Pacific Time (PT).

For example, a GetDailyReportLogs request might look like the following:

http://deimos.apple.com/WebObjects/Core.woa/API/GetDailyReportLogs/example.edu?StartDate=2007-09-12&EndDate=2007-09-13&credentials=Administrator@urn:mace:itunesu.com:sites:example.edu&identity=%22Jane+Doe%22+%3Cjdoe%40example.edu%3E+%28jdoe%29+%5B42%5D&signature=38bda70d9aa6975ae8756754034feb6e3c794aca4b21665f6dc85d2ed42d4f6b

Or, from the command line:

/usr/bin/curl "http://deimos.apple.com/WebObjects/Core.woa/API/GetDailyReportLogs/example.edu?StartDate=2007-09-12&EndDate=2007-09-13&credentials=Administrator@urn:mace:itunesu.com:sites:example.edu&identity=%22Jane+Doe%22+%3Cjdoe%40example.edu%3E+%28jdoe%29+%5B42%5D&signature=38bda70d9aa6975ae8756754034feb6e3c794aca4b21665f6dc85d2ed42d4f6b"

The iTunes U daily log report returns information for the following space-delimited fields:

Log Format Version
Site Name
Date of Log Entry
Time of Log Entry
Action
Destination String
User Information
IP Address
Client
Path

The following is an illustration of sample output from an iTunes U daily report log:

1.0 sample.edu 2007-08-07 10:56:29.453-07:00 Browse sample.edu AppleAdministrator@sample.edu 0.0.0.0 iTunes/7.3.2/Macintosh "Sample College > Sample Course"
1.0 sample.edu 2007-08-07 11:11:46.972-07:00 Browse sample.edu AppleAdministrator@sample.edu 0.0.0.0 iTunes/7.3.2/Macintosh "Sample College"
1.0 sample.edu 2007-08-07 12:10:34.166-07:00 Upload sample.edu member@itunesu.com 0.0.0.0 ?/?/? "Sample College" "XMLControlFile" 0 0
1.0 sample.edu 2007-08-07 12:11:55.708-07:00 Browse sample.edu AppleAdministrator@sample.edu 0.0.0.0 iTunes/7.3.2/Macintosh "Sample College > Sample Course"
1.0 sample.edu 2007-08-07 12:23:11.028-07:00 Browse sample.edu AppleAdministrator@sample.edu 0.0.0.0 iTunes/7.3.2/Macintosh "Sample College"
1.0 sample.edu 2007-08-07 12:29:18.993-07:00 Upload sample.edu member@itunesu.com 0.0.0.0 ?/?/? "Sample College" "XMLControlFile" 0 0
1.0 sample.edu 2007-08-07 12:34:31.522-07:00 Browse sample.edu AppleAdministrator@sample.edu 0.0.0.0 iTunes/7.3.2/Macintosh "Sample College"
1.0 sample.edu 2007-08-07 14:10:58.363-07:00 EditPage sample.edu AppleAdministrator@sample.edu 0.0.0.0 iTunes/7.3.2/Macintosh "Sample College > Sample Course"
1.0 sample.edu 2007-08-07 14:41:33.552-07:00 Browse sample.edu AppleAdministrator@sample.edu 0.0.0.0 iTunes/7.3.2/Macintosh "Sample College > Topics > Sample Topic"
1.0 sample.edu 2007-08-07 16:24:37.858-07:00 Browse sample.edu AppleAdministrator@sample.edu 0.0.0.0 iTunes/7.3.2/Macintosh "Sample College"
1.0 sample.edu 2007-08-07 16:25:11.726-07:00 Upload sample.edu member@itunesu.com 0.0.0.0 ?/?/? "Sample College" "XMLControlFile" 0 0
1.0 sample.edu 2007-08-07 16:28:24.010-07:00 Browse sample.edu AppleAdministrator@sample.edu 0.0.0.0 iTunes/7.3.2/Macintosh "Sample College"

Next Previous