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" |
© 2011 Apple Inc. All Rights Reserved. (Last updated: 2011-11-03)