Эта страница переведена с помощью Cloud Translation API.

Устранить ошибки

API Gmail возвращает информацию об ошибках двух уровней:

Коды и сообщения об ошибках HTTP в заголовке.
В теле ответа содержится JSON-объект с дополнительными сведениями, которые помогут определить, как обработать ошибку.

Приложения Gmail должны перехватывать и обрабатывать все ошибки, которые могут возникнуть при использовании REST API. В этом руководстве приведены инструкции по устранению конкретных ошибок API.

Устранение ошибки 400: Неверный запрос

Эта ошибка может быть вызвана следующими ошибками в вашем коде:

Не указано обязательное поле или параметр.
Указанное значение или комбинация указанных полей недопустимы.
Недействительное вложение.

Ниже приведен пример JSON-представления этой ошибки:

{
  "error": {
    "code": 400,
    "errors": [
      {
        "domain": "global",
        "location": "orderBy",
        "locationType": "parameter",
        "message": "Sorting is not supported for queries with fullText terms. Results are always in descending relevance order.",
        "reason": "badRequest"
      }
    ],
    "message": "Sorting is not supported for queries with fullText terms. Results are always in descending relevance order."
  }
}

Чтобы исправить эту ошибку, проверьте поле message и внесите соответствующие изменения в свой код.

Устранение ошибки 401: Неверные учетные данные

Ошибка 401 указывает на то, что используемый вами токен доступа либо просрочен, либо недействителен. Эта ошибка также может быть вызвана отсутствием авторизации для запрошенных областей действия. Ниже приведено JSON-представление этой ошибки:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "authError",
        "message": "Invalid Credentials",
        "locationType": "header",
        "location": "Authorization",
      }
    ],
    "code": 401,
    "message": "Invalid Credentials"
  }
}

Для устранения этой ошибки обновите токен доступа, используя долгосрочный токен обновления. Если вы используете клиентскую библиотеку, она автоматически обрабатывает обновление токена. Если это не удается, направьте пользователя через процесс OAuth, как описано в разделе «Авторизация вашего приложения с помощью Gmail» .