API календаря возвращает два уровня информации об ошибках:
- Коды ошибок HTTP и сообщения в заголовке
- Объект JSON в теле ответа с дополнительной информацией, которая поможет вам определить, как обрабатывать ошибку.
Остальная часть этой страницы содержит справочник по ошибкам Календаря и некоторые рекомендации по их устранению в вашем приложении.
Реализовать экспоненциальную задержку
В документации по облачным API содержится хорошее объяснение экспоненциальной задержки и того, как ее использовать с API Google.
Ошибки и предлагаемые действия
В этом разделе представлено полное JSON-представление каждой из перечисленных ошибок, а также предлагаемые действия для их устранения.
400: Неверный запрос
Ошибка пользователя. Это может означать, что обязательное поле или параметр не указаны, предоставленное значение недопустимо или комбинация предоставленных полей недопустима.
{
"error": {
"errors": [
{
"domain": "calendar",
"reason": "timeRangeEmpty",
"message": "The specified time range is empty.",
"locationType": "parameter",
"location": "timeMax",
}
],
"code": 400,
"message": "The specified time range is empty."
}
}
Рекомендуемое действие: Поскольку это постоянная ошибка, не повторяйте попытку. Вместо этого прочитайте сообщение об ошибке и измените свой запрос соответствующим образом.
401: Недействительные учетные данные
Недопустимый заголовок авторизации. Используемый вами токен доступа либо устарел, либо недействителен.
{
"error": {
"errors": [
{
"domain": "global",
"reason": "authError",
"message": "Invalid Credentials",
"locationType": "header",
"location": "Authorization",
}
],
"code": 401,
"message": "Invalid Credentials"
}
}
Предлагаемые действия:
- Получите новый токен доступа, используя долгосрочный токен обновления.
- Если это не удается, направьте пользователя через поток OAuth, как описано в разделе Авторизация запросов с помощью OAuth 2.0 .
- Если вы видите это сообщение для учетной записи службы, убедитесь, что вы успешно выполнили все шаги на странице учетной записи службы .
403: Превышен лимит количества пользователей
Достигнут один из лимитов Консоли разработчика.
{
"error": {
"errors": [
{
"domain": "usageLimits",
"reason": "userRateLimitExceeded",
"message": "User Rate Limit Exceeded"
}
],
"code": 403,
"message": "User Rate Limit Exceeded"
}
}
Предлагаемые действия:
- Убедитесь, что ваше приложение соответствует лучшим практикам управления квотами .
- Увеличьте квоту для каждого пользователя в проекте Developer Console.
- Если один пользователь выполняет множество запросов от имени многих пользователей учетной записи Google Workspace, рассмотрите возможность использования учетной записи службы с делегированием на уровне домена и настройкой параметра
quotaUser. - Используйте экспоненциальную задержку .
403: Превышен лимит скорости
Пользователь достиг максимальной частоты запросов API Календаря Google на календарь или на одного аутентифицированного пользователя.
{
"error": {
"errors": [
{
"domain": "usageLimits",
"reason": "rateLimitExceeded",
"message": "Rate Limit Exceeded"
}
],
"code": 403,
"message": "Rate Limit Exceeded"
}
}
Рекомендуемое действие: ошибки rateLimitExceeded могут возвращать коды 403 или 429 — в настоящее время они функционально схожи и должны обрабатываться одинаково, с использованием экспоненциальной задержки . Кроме того, убедитесь, что ваше приложение соответствует рекомендациям из раздела «Управление квотами» .
403: Превышен лимит использования календаря
Пользователь достиг одного из ограничений Календаря Google, установленных для защиты пользователей и инфраструктуры Google от злоупотреблений.
{
"error": {
"errors": [
{
"domain": "usageLimits",
"message": "Calendar usage limits exceeded.",
"reason": "quotaExceeded"
}
],
"code": 403,
"message": "Calendar usage limits exceeded."
}
}
Предлагаемые действия:
- Подробнее об ограничениях на использование Календаря читайте в справке администратора Google Workspace .
403: Запрещено для неорганизаторов
Запрос на обновление события пытается установить одно из общих свойств события в копии, которая не принадлежит организатору. Общие свойства (например, guestsCanInviteOthers , guestsCanModify или guestsCanSeeOtherGuests ) могут быть установлены только организатором.
{
"error": {
"errors": [
{
"domain": "calendar",
"reason": "forbiddenForNonOrganizer",
"message": "Shared properties can only be changed by the organizer of the event."
}
],
"code": 403,
"message": "Shared properties can only be changed by the organizer of the event."
}
}
Предлагаемые действия:
- Если вы используете Events: insert , Events: import или Events: update , и ваш запрос не содержит общих свойств, это эквивалентно попытке установить для них значения по умолчанию. Вместо этого рассмотрите возможность использования Events: patch .
- Если ваш запрос имеет общие свойства, убедитесь, что вы пытаетесь изменить эти свойства только в том случае, если вы обновляете копию организатора.
404: Не найдено
Указанный ресурс не найден. Это может произойти в нескольких случаях. Вот несколько примеров:
- когда запрашиваемый ресурс (с предоставленным идентификатором) никогда не существовал
при доступе к календарю, к которому пользователь не может получить доступ
{ "error": { "errors": [ { "domain": "global", "reason": "notFound", "message": "Не найдено" } ], "code": 404, "message": "Не найдено" } }
Предлагаемое действие: использовать экспоненциальную задержку .
409: Запрошенный идентификатор уже существует
Экземпляр с указанным идентификатором уже существует в хранилище.
{
"error": {
"errors": [
{
"domain": "global",
"reason": "duplicate",
"message": "The requested identifier already exists."
}
],
"code": 409,
"message": "The requested identifier already exists."
}
}
Предлагаемое действие: создайте новый идентификатор, если вы хотите создать новый экземпляр, в противном случае используйте вызов метода обновления .
409: Конфликт
Пакетный элемент внутри операции events.batch не может быть выполнен из-за операционного конфликта с другими запрошенными пакетными элементами.
{
"error": {
"errors": [
{
"domain": "global",
"reason": "conflict",
"message": "Conflict"
}
],
"code": 409,
"message": "Conflict"
}
}
Предлагаемое действие: исключить все успешно завершенные и все определенно невыполненные пакетные элементы и повторить оставшиеся в другом events.batch или соответствующих операциях с одним событием.
410: Ушел
Параметры syncToken или updatedMin больше недействительны. Эта ошибка также может возникнуть, если запрос пытается удалить уже удалённое событие.
{
"error": {
"errors": [
{
"domain": "calendar",
"reason": "fullSyncRequired",
"message": "Sync token is no longer valid, a full sync is required.",
"locationType": "parameter",
"location": "syncToken",
}
],
"code": 410,
"message": "Sync token is no longer valid, a full sync is required."
}
}
или
{
"error": {
"errors": [
{
"domain": "calendar",
"reason": "updatedMinTooLongAgo",
"message": "The requested minimum modification time lies too far in the past.",
"locationType": "parameter",
"location": "updatedMin",
}
],
"code": 410,
"message": "The requested minimum modification time lies too far in the past."
}
}
или
{
"error": {
"errors": [
{
"domain": "global",
"reason": "deleted",
"message": "Resource has been deleted"
}
],
"code": 410,
"message": "Resource has been deleted"
}
}
Рекомендуемое действие: для параметров syncToken или updatedMin очистите хранилище и выполните повторную синхронизацию. Подробнее см. в разделе «Эффективная синхронизация ресурсов» . Для уже удалённых событий дальнейшие действия не требуются.
412: Предварительное условие не выполнено
Тег etag, указанный в заголовке If-match, больше не соответствует текущему тегу etag ресурса.
{
"error": {
"errors": [
{
"domain": "global",
"reason": "conditionNotMet",
"message": "Precondition Failed",
"locationType": "header",
"location": "If-Match",
}
],
"code": 412,
"message": "Precondition Failed"
}
}
Рекомендуемое действие: повторно загрузить объект и повторно применить изменения. Подробнее см. в разделе Получение определённых версий ресурсов .
429: Слишком много запросов
Ошибка rateLimitExceeded возникает, когда пользователь отправил слишком много запросов за определенный промежуток времени.
{
"error": {
"errors": [
{
"domain": "usageLimits",
"reason": "rateLimitExceeded",
"message": "Rate Limit Exceeded"
}
],
"code": 429,
"message": "Rate Limit Exceeded"
}
}
Рекомендуемое действие: ошибки rateLimitExceeded могут возвращать коды 403 или 429 — в настоящее время они функционально схожи и должны обрабатываться одинаково, с использованием экспоненциальной задержки . Кроме того, убедитесь, что ваше приложение соответствует рекомендациям из раздела «Управление квотами» .
500: Ошибка бэкэнда
При обработке запроса произошла непредвиденная ошибка.
{
"error": {
"errors": [
{
"domain": "global",
"reason": "backendError",
"message": "Backend Error",
}
],
"code": 500,
"message": "Backend Error"
}
}
Предлагаемое действие: использовать экспоненциальную задержку .