google-analytics-api Error Responses


  • 400 invalidParameter Indicates that a request parameter has an invalid value.

  • 400 badRequest Indicates that the query was invalid. E.g., parent ID was missing or the combination of dimensions or metrics requested was not valid.

  • 403 insufficientPermissions Indicates that the user does not have sufficient permissions for the entity specified in the query.

  • 403 dailyLimitExceeded Indicates that user has exceeded the daily quota (either per project or per view (profile)).

  • 403 usageLimits.userRateLimitExceededUnreg Indicates that the application needs to be registered in the Google API Console.

  • 403 userRateLimitExceeded Indicates that the user rate limit has been exceeded. The maximum rate limit is 10 qps per IP address.

  • 403 rateLimitExceeded Indicates that the global or overall project rate limits have been exceeded. Retry using exponential back-off. You need to slow down the rate at which you are sending the requests.

  • 403 quotaExceeded Indicates that the 10 concurrent requests per view (profile) in the Core Reporting API has been reached.

  • 429 RESOURCE_EXHAUSTED AnalyticsDefaultGroupCLIENT_PROJECT-1d Indicates that the Requests per day per project quota has been exhausted.

  • 429 RESOURCE_EXHAUSTED AnalyticsDefaultGroupCLIENT_PROJECT-100s Indicates that the Requests per 100 seconds per project quota has been exhausted.

  • 429 RESOURCE_EXHAUSTED AnalyticsDefaultGroupUSER-100s Indicates that the requests per 100 seconds per user per project quota has been exhausted.

  • 429 RESOURCE_EXHAUSTED DiscoveryGroupCLIENT_PROJECT-100s Indicates that the discovery requests per 100 seconds quota has been exhausted.

  • 500 internalServerError Unexpected internal server error occurred. Do not retry this query more than once.

  • 503 backendError Server returned an error. Do not retry this query more than once.


domainLocation of the error ex: global
reasonReason for the error
messageA message explaining the error and a possible solution.
locationTypeThe location type of the error ex: paramater
locationThe actual location of the error


If an request is successful, the API returns a 200 HTTP status code along with the requested data in the body of the response.

If an error occurs with a request, the API returns an HTTP status code and reason in the response based on the type of error. Additionally, the body of the response contains a detailed description of what caused the error.