Gmail Integration Terminal Errors

Authentication Errors

invalid_client

Error: invalid_client
{
  "error": "invalid_client",
  "error_description": "The OAuth client was not found."
}

access_denied

Error: access_denied
{
  "error": "access_denied",
  "error_description": "The user denied your request"
}

invalid_grant

Error: invalid_grant
{
  "error": "invalid_grant",
  "error_description": "Bad Request"
}

API Errors

quotaExceeded

HTTP 403 Forbidden
{
  "error": {
    "errors": [
      {
        "domain": "usageLimits",
        "reason": "quotaExceeded",
        "message": "Quota exceeded for quota metric 'Queries' and limit 'Queries per minute per user' of service 'gmail.googleapis.com' for consumer 'project_number:123456789'."
      }
    ],
    "code": 403,
    "message": "Quota exceeded for quota metric 'Queries' and limit 'Queries per minute per user' of service 'gmail.googleapis.com' for consumer 'project_number:123456789'."
  }
}

insufficientPermissions

HTTP 403 Forbidden
{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "insufficientPermissions",
        "message": "Insufficient Permission"
      }
    ],
    "code": 403,
    "message": "Insufficient Permission"
  }
}

invalidArgument

HTTP 400 Bad Request
{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "invalidArgument",
        "message": "Invalid value for: Invalid format: 2023-13-45T25:61:61.000Z is not a valid date and time."
      }
    ],
    "code": 400,
    "message": "Invalid value for: Invalid format: 2023-13-45T25:61:61.000Z is not a valid date and time."
  }
}

SDK-Specific Errors

Python SDK: google.auth.exceptions.RefreshError

Traceback (most recent call last):
  File "gmail_script.py", line 15, in <module>
    service = build('gmail', 'v1', credentials=creds)
  File "/usr/local/lib/python3.9/site-packages/googleapiclient/discovery.py", line 286, in build
    request = service._http.request(uri)
  File "/usr/local/lib/python3.9/site-packages/googleapiclient/http.py", line 907, in execute
    self._execute(num_retries)
  File "/usr/local/lib/python3.9/site-packages/googleapiclient/http.py", line 942, in execute
    raise HttpError(resp, content, uri=self.uri)
googleapiclient.errors.HttpError: <HttpError 401 when requesting https://www.googleapis.com/gmail/v1/users/me/messages?alt=json returned "Request had invalid authentication credentials. Expected OAuth 2 access token, login cookie or other valid authentication credential. See https://developers.google.com/identity/sign-in/web/devconsole-project.">

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "gmail_script.py", line 15, in <module>
    creds = get_credentials()
  File "gmail_script.py", line 45, in get_credentials
    creds.refresh(Request())
google.auth.exceptions.RefreshError: ('invalid_grant: Bad Request', {'error': 'invalid_grant', 'error_description': 'Bad Request'})

Node.js SDK: GaxiosError

GaxiosError: invalid_client
    at Gaxios._request (/node_modules/gaxios/src/gaxios.ts:160:13)
    at processTicksAndRejections (internal/process/task_queues.js:95:5)
    at async Gmail.users.messages.list (/node_modules/googleapis/src/apis/gmail/v1.ts:1234:15)
    at async main (/app/index.js:23:18)
{
  response: {
    config: { url: 'https://www.googleapis.com/oauth2/v4/token', method: 'POST' },
    data: { error: 'invalid_client', error_description: 'The OAuth client was not found.' },
    status: 400,
    statusText: 'Bad Request',
    headers: {
      'content-type': 'application/json; charset=utf-8',
      'cache-control': 'no-cache, no-store, max-age=0, must-revalidate',
      'pragma': 'no-cache',
      'expires': 'Mon, 01 Jan 1990 00:00:00 GMT'
    }
  }
}

Connection Errors

timeout

Error: timeout of 30000ms exceeded
    at createError (/node_modules/axios/lib/core/createError.js:16:15)
    at Timeout.handleTimeout [as _onTimeout] (/node_modules/axios/lib/adapters/http.js:280:16)
    at listOnTimeout (timers.js:557:17)
    at processTimers (timers.js:500:7)

Rate Limiting

userRateLimitExceeded

HTTP 429 Too Many Requests
{
  "error": {
    "errors": [
      {
        "domain": "usageLimits",
        "reason": "userRateLimitExceeded",
        "message": "User-rate limit exceeded. Retry after 2023-12-07T15:30:00.000Z"
      }
    ],
    "code": 429,
    "message": "User-rate limit exceeded. Retry after 2023-12-07T15:30:00.000Z"
  }
}