Unclear documentation of GA quota limitations

[GoogleCodeExporter]

Name of API affected:
Analytics Data Export API

The GA quota policy documentation available from 
http://code.google.com/apis/analytics/docs/gdata/gdataDeveloperGuide.html#quota 
is unclear at some points:

- It mentions the 10 qps limit *per application* however it does not define an 
'application'. According to Nick's post at 
http://groups.google.com/group/google-analytics-data-export-api/browse_thread/th
read/4ecd214053f7e925 it refers to "mostly IP". It would be very helpful to 
state if it's per API (or per network or so on). 

- It mentions the limitation to 4 concurrent requests but it's not clear if the 
concurrent requests count per web property, IP address, network etc.

- It does not mention what happens if an application reaches the limit of 
requests per second or the limit of parallel requests and when the user can 
expect the GA API stops responding again.

A better description of these limitation would be very helpful for developers 
who _accidentally_ reach a quota limitation and investigate the possible 
causes. Note the quota limitation may be reached not only because of a poorly 
written code but also due to an interference of another application running on 
the same machine (or even network?) - and it's very hard to guess this from the 
current description of the quota policy.

Regards,
Pavel

Original issue reported on code.google.com by pavel.ko...@gmail.com on 24 Nov 2010 at 8:24

[GoogleCodeExporter]

Moreover, it would be very useful to document the status codes sent with 503 
ServiceUnavailable (and make sure they can be used to diagnose which of the 
quota limitations has been reached).

Original comment by pavel.ko...@gmail.com on 24 Nov 2010 at 8:31

[GoogleCodeExporter]

We updated the docs to be more specific about the quota.
http://code.google.com/apis/analytics/docs/gdata/gdataDeveloperGuide.html#quota

We'll continue to look at documenting the status codes. but for now I'm going 
to close this bug as it deals with quota.

Original comment by nickski1...@gmail.com on 9 Dec 2010 at 12:24

• Changed state: Verified

[GoogleCodeExporter]

Removing an obsolete label that was used when these issues were in the 
gdata-issues project.

Original comment by jrobbins@google.com on 21 Jul 2011 at 10:04

• Removed labels: API-Analytics