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

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

API Google Drive возвращает два уровня информации об ошибках:

Коды ошибок HTTP и заголовочные сообщения.
Объект JSON в теле ответа с дополнительной информацией, которая поможет вам определить, как обрабатывать ошибку.

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

Сводка кодов состояния HTTP

Код ошибки	Описание
`200 - OK`	Запрос выполнен успешно (это стандартный ответ для успешных HTTP-запросов).
`400 - Bad Request`	Запрос не может быть выполнен из-за ошибки клиента в запросе.
`401 - Unauthorized`	Запрос содержит недействительные учетные данные.
`403 - Forbidden`	Запрос был получен и понят, но у пользователя нет разрешения на выполнение запроса.
`404 - Not Found`	Запрошенная страница не найдена.
`429 - Too Many Requests`	Слишком много запросов к API.
`500, 502, 503, 504 - Server Errors`	При обработке запроса возникла непредвиденная ошибка.

400 ошибок

Эти ошибки означают, что запрос неприемлем, часто из-за отсутствия обязательного параметра.

`badRequest`

Эта ошибка может возникнуть из-за любой из следующих проблем в вашем коде:

Обязательное поле или параметр не предоставлены.
Указанное значение или комбинация предоставленных полей недействительны.
Вы попытались добавить дубликат родительского файла к файлу на Диске.
Вы попытались добавить родительский элемент, который создал бы цикл в графе каталогов.

Следующий пример 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 и исправьте код соответствующим образом.

`illegalKeepForeverModification`

Эта ошибка возникает при попытке установить для версии BLOB-файла, помеченной как «Keep Forever», значение false . Следующий пример JSON иллюстрирует эту ошибку:

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "illegalKeepForeverModification",
    "message": "Bad Request. Cannot update a revision to false that is marked as keepForever."
   }
  ],
  "code": 400,
  "message": "Bad Request. Cannot update a revision to false that is marked as keepForever."
 }
}

Чтобы исправить эту ошибку, окончательно удалите версию файла BLOB-объекта, чтобы отключить настройку «Хранить навсегда».

`invalidSharingRequest`

Эта ошибка возникает по нескольким причинам. Чтобы определить причину, проверьте поле reason в возвращаемом JSON-файле. Чаще всего эта ошибка возникает по следующим причинам:

Отправка прошла успешно, но письмо с уведомлением не было доставлено корректно.
Изменение списка контроля доступа (ACL) не разрешено для этого пользователя.

Поле message указывает фактическую ошибку.

Поделиться удалось, но уведомление по электронной почте не было доставлено корректно.

Следующий пример JSON представляет собой представление этой ошибки:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "invalidSharingRequest",
        "message": "Bad Request. User message: \"Sorry, the items were successfully shared but emails could not be sent to email@domain.com.\""
      }
    ],
    "code": 400,
    "message": "Bad Request"
  }
}

Чтобы исправить эту ошибку, сообщите пользователю (отправителю), что он не смог поделиться файлом, поскольку уведомление не было отправлено на целевой адрес электронной почты. Пользователь должен убедиться, что его адрес электронной почты правильный и на него можно получать письма.

Изменение ACL не разрешено для этого пользователя.

Следующий пример JSON представляет собой представление этой ошибки:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "invalidSharingRequest",
        "message": "Bad Request. User message: \"ACL change not allowed.\""
      }
    ],
    "code": 400,
    "message": "Bad Request"
  }
}

Чтобы исправить эту ошибку, проверьте настройки общего доступа домена Google Workspace, к которому принадлежит файл. Возможно, настройки запрещают общий доступ за пределами домена или общий доступ к общему диску.

401 ошибка

Эти ошибки означают, что запрос не содержит действительного токена доступа.

`authError`

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

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

Чтобы исправить эту ошибку, обновите токен доступа, используя долгосрочный токен обновления. Если это не поможет, направьте пользователя через процедуру OAuth, как описано в разделе Выбор областей действия API Google Диска .

`fileNotDownloadable`

Эта ошибка возникает при попытке использовать метод revisions.get с параметром URL alt=media в документе Google Workspace. Следующий пример JSON иллюстрирует эту ошибку:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "fileNotDownloadable",
        "message": "Only files with binary content can be downloaded. Use Export with Docs Editors files."
      }
    ],
    "code": 403,
    "message": "Only files with binary content can be downloaded. Use Export with Docs Editors files."
  }
}

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

Удалите параметр URL alt=media если вы хотите просмотреть метаданные конкретной версии, например тип MIME.
Для экспорта байтового содержимого документа Google Workspace используйте метод files.export . Подробнее см. в разделе Экспорт содержимого документа Google Workspace .

403 ошибки

Эти ошибки означают, что превышен лимит использования или у пользователя нет необходимых прав. Чтобы определить причину, проверьте поле reason в возвращаемом JSON-коде.

Информацию об ограничениях API Диска см. в разделе «Ограничения использования» . Информацию об ограничениях папок Диска см. в разделе «Ограничения файлов и папок» .

`activeItemCreationLimitExceeded`

Ошибка activeItemCreationLimitExceeded возникает при превышении лимита на количество элементов, создаваемых для одной учётной записи. Каждый пользователь может создать до 500 миллионов элементов в одной учётной записи. Подробнее см. в разделе «Лимит для пользователя» .

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "activeItemCreationLimitExceeded",
    "message": "This account has exceeded the creation limit of 500 million items. To create more items, permanently delete some items."
   }
  ],
  "code": 403,
  "message": "This account has exceeded the creation limit of 500 million items. To create more items, permanently delete some items."
 }
}

Чтобы исправить эту ошибку:

Сообщите пользователю, что Диск запрещает аккаунтам создавать более 500 миллионов элементов.
Если пользователю необходимо создавать объекты в этой же учётной записи, попросите его безвозвратно удалить некоторые объекты. В противном случае он может использовать другую учётную запись, которая уже соответствует этому требованию.

`appNotAuthorizedToFile`

Эта ошибка возникает, когда ваше приложение не входит в список контроля доступа (ACL) для файла. Эта ошибка не позволяет пользователю открыть файл в вашем приложении. Следующий пример JSON иллюстрирует эту ошибку:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "appNotAuthorizedToFile",
        "message": "The user has not granted the app {appId} {verb} access to the file {fileId}."
      }
    ],
    "code": 403,
    "message": "The user has not granted the app {appId} {verb} access to the file {fileId}."
  }
}

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

Откройте окно выбора Google Диска и предложите пользователю открыть файл.
Попросите пользователя открыть файл с помощью контекстного меню «Открыть с помощью» в пользовательском интерфейсе Диска вашего приложения.
Используйте метод files.get для проверки поля isAppAuthorized в ресурсе files , чтобы убедиться, что ваше приложение создало или открыло файл.

`cannotModifyInheritedTeamDrivePermission`

Эта ошибка возникает, когда пользователь пытается изменить унаследованные разрешения элемента на общем диске. Унаследованные разрешения нельзя удалить из элемента на общем диске. Следующий пример JSON иллюстрирует эту ошибку:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "cannotModifyInheritedTeamDrivePermission",
        "message": "Cannot update or delete an inherited permission on a shared drive item."
      }
    ],
    "code": 403,
    "message": "Cannot update or delete an inherited permission on a shared drive item."
  }
}

Чтобы исправить эту ошибку, пользователь должен настроить разрешения для прямого или косвенного родительского элемента, от которого они были унаследованы. Подробнее см. в разделе «Как работают разрешения» . Вы также можете получить ресурс permissions , чтобы узнать, унаследованы ли разрешения для этого элемента общего диска или применены напрямую.

`dailyLimitExceeded`

Эта ошибка возникает при достижении лимита API для вашего проекта. Следующий пример JSON иллюстрирует эту ошибку:

{
  "error": {
    "errors": [
      {
        "domain": "usageLimits",
        "reason": "dailyLimitExceeded",
        "message": "Daily Limit Exceeded"
      }
    ],
    "code": 403,
    "message": "Daily Limit Exceeded"
  }
}

Эта ошибка возникает, когда владелец приложения установил квоту на использование определённого ресурса. Чтобы исправить эту ошибку, снимите все ограничения на использование квоты «Запросов в день» .

`domainPolicy`

Эта ошибка возникает, когда политика домена пользователя не разрешает доступ к Диску через ваше приложение. Следующий пример JSON иллюстрирует эту ошибку:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "domainPolicy",
        "message": "The domain administrators have disabled Drive apps."
      }
    ],
    "code": 403,
    "message": "The domain administrators have disabled Drive apps."
  }
}

Чтобы исправить эту ошибку:

Сообщите пользователю, что домен не позволяет вашему приложению получать доступ к файлам на Диске.
Попросите пользователя обратиться к администратору домена, чтобы запросить доступ к вашему приложению.

`downloadRestrictedForRevision`

Эта ошибка возникает, когда пользователь не может загрузить версию BLOB-файла. Следующий пример JSON иллюстрирует эту ошибку:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "download_restricted_for_revision",
        "message": "This revision cannot be downloaded by the authenticated user."
      }
    ],
    "code": 403,
    "message": "This revision cannot be downloaded by the authenticated user."
  }
}

Чтобы исправить эту ошибку, сообщите пользователю, что единственный способ загрузить версии BLOB-файла — это пометить их как «Сохранить навсегда». Подробнее см. в разделе «Укажите версии для сохранения от автоматического удаления» .

`fileOwnerNotMemberOfTeamDrive`

Эта ошибка возникает при попытке переместить файл на общий диск, если владелец файла не является его участником. Следующий пример JSON иллюстрирует эту ошибку:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "fileOwnerNotMemberOfTeamDrive",
        "message": "Cannot move a file into a shared drive as a writer when the owner of the file is not a member of that shared drive."
      }
    ],
    "code": 403,
    "message": "Cannot move a file into a shared drive as a writer when the owner of the file is not a member of that shared drive."
  }
}

Чтобы исправить эту ошибку:

Добавьте участника к общему диску с role=owner . Подробнее см. в разделе Общий доступ к файлам, папкам и дискам .
Добавьте файл на общий диск. Подробнее см. в разделе Создание и заполнение папок .

`fileWriterTeamDriveMoveInDisabled`

Эта ошибка возникает, когда администратор домена не разрешил пользователям с role=writer перемещать элементы на общий диск. Пользователь, пытающийся переместить элементы, имеет меньше прав, чем разрешено на целевом общем диске. Следующий пример JSON иллюстрирует эту ошибку:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "fileWriterTeamDriveMoveInDisabled",
        "message": "The domain administrator has not allowed writers to move items into a shared drive."
      }
    ],
    "code": 403,
    "message": "The domain administrator has not allowed writers to move items into a shared drive."
  }
}

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

`insufficientFilePermissions`

Эта ошибка возникает, когда у пользователя нет прав на запись в файл, а ваше приложение пытается его изменить. Следующий пример JSON иллюстрирует эту ошибку:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "insufficientFilePermissions",
        "message": "The user does not have sufficient permissions for file {fileId}."
      }
    ],
    "code": 403,
    "message": "The user does not have sufficient permissions for file {fileId}."
  }
}

Чтобы исправить эту ошибку, попросите пользователя связаться с владельцем файла и запросить разрешение на редактирование. Вы также можете проверить уровни доступа пользователя в метаданных, полученных методом files.get , и отобразить интерфейс только для чтения при отсутствии разрешений.

`myDriveHierarchyDepthLimitExceeded`

Ошибка myDriveHierarchyDepthLimitExceeded возникает при превышении ограничения на количество уровней вложенности папок. Раздел «Мой диск» пользователя не может содержать более 100 уровней вложенности папок. Подробнее см. в разделе Ограничение на глубину папок .

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "myDriveHierarchyDepthLimitExceeded",
    "message": "Your My Drive can't contain more than 100 levels of folders. For details, see https://developers.google.com/workspace/drive/api/guides/handle-errors#nested-folder-levels."
   }
  ],
  "code": 403,
  "message": "Your My Drive can't contain more than 100 levels of folders. For details, see https://developers.google.com/workspace/drive/api/guides/handle-errors#nested-folder-levels."
 }
}

Чтобы исправить эту ошибку:

Сообщите пользователю, что Диск не позволяет размещать папки глубиной более 100 уровней.
Если пользователю необходимо создать еще одну вложенную папку, попросите его реорганизовать предполагаемую родительскую папку так, чтобы ее глубина была менее 100 уровней, или использовать другую родительскую папку, которая уже соответствует этому требованию.

`numChildrenInNonRootLimitExceeded`

Эта ошибка возникает, когда превышен лимит на количество дочерних элементов папки (папок, файлов и ярлыков). Для папок, файлов и ярлыков, находящихся непосредственно в папке, установлено ограничение в 500 000 элементов. Элементы, вложенные в подпапки, не учитываются в этом лимите. Подробнее об ограничениях на количество папок на Диске см. в статье Ограничения на количество папок в Google Диске .

Следующий пример JSON представляет собой представление этой ошибки:

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "numChildrenInNonRootLimitExceeded",
    "message": "The limit for this folder's number of children (files and folders) has been exceeded."
   }
  ],
  "code": 403,
  "message": "The limit for this folder's number of children (files and folders) has been exceeded."
 }
}

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

Сообщите пользователю, что Диск блокирует папки, содержащие более 500 000 элементов.
Если пользователю необходимо добавить больше элементов в полную папку, попросите его реорганизовать папку так, чтобы она содержала менее 500 000 элементов, или использовать похожую папку, которая уже содержит меньше элементов.

`rateLimitExceeded`

Эта ошибка возникает при достижении лимита скорости проекта. Этот лимит зависит от типа запроса. Следующий пример JSON иллюстрирует эту ошибку:

{
 "error": {
  "errors": [
   {
    "domain": "usageLimits",
    "message": "Rate Limit Exceeded",
    "reason": "rateLimitExceeded",
   }
  ],
  "code": 403,
  "message": "Rate Limit Exceeded"
 }
}

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

Увеличьте квоту для каждого пользователя в проекте Google Cloud. Для получения дополнительной информации отправьте запрос на увеличение квоты .
Пакетные запросы для объединения нескольких вызовов API в один HTTP-запрос.
Используйте экспоненциальную задержку для повторной попытки запроса.

`sharingRateLimitExceeded`

Эта ошибка возникает, когда пользователь достигает лимита на отправку сообщений, и часто связана с лимитом на количество электронных писем. Следующий пример JSON иллюстрирует эту ошибку:

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "message": "Rate limit exceeded. User message: \"These item(s) could not be shared because a rate limit was exceeded: filename",
    "reason": "sharingRateLimitExceeded",
   }
  ],
  "code": 403,
  "message": "Rate Limit Exceeded"
 }
}

Чтобы исправить эту ошибку:

Не отправляйте электронные письма при обмене большими объемами файлов.
Если один пользователь делает многочисленные запросы от имени многих пользователей учетной записи Google Workspace, рассмотрите возможность использования учетной записи службы с делегированием на уровне домена с помощью параметра quotaUser .

`storageQuotaExceeded`

Эта ошибка возникает, когда пользователь достигает лимита хранилища. Следующий пример JSON иллюстрирует эту ошибку:

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "message": "The user's Drive storage quota has been exceeded.",
    "reason": "storageQuotaExceeded",
   }
  ],
  "code": 403,
  "message": "The user's Drive storage quota has been exceeded."
 }
}

Чтобы исправить эту ошибку:

Проверьте ограничения на хранилище вашего аккаунта Google Диска. Подробнее см. в статье «Ограничения на хранилище и загрузку Google Workspace» .
Управляйте своим хранилищем на Диске, Gmail и Google Photos .
Купите больше места в хранилище Google .

`teamDriveFileLimitExceeded`

Эта ошибка возникает, когда пользователь пытается превысить строгий лимит на количество элементов на общем диске. Каждая папка на общем диске пользователя имеет ограничение в 500 000 элементов, включая файлы, папки и ярлыки. Это ограничение основано на количестве элементов, а не на использовании хранилища. Подробнее см. в статье Ограничения на общие диски в Google Диске .

Следующий пример JSON представляет собой представление этой ошибки:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "teamDriveFileLimitExceeded",
        "message": "The file limit for this shared drive has been exceeded."
      }
    ],
    "code": 403,
    "message": "The file limit for this shared drive has been exceeded."
  }
}

Чтобы исправить эту ошибку, уменьшите количество объектов на общем диске. На общих дисках со слишком большим количеством файлов может быть сложно организовать и выполнять поиск.

`teamDriveHierarchyTooDeep`

Ошибка teamDriveHierarchyTooDeep возникает при превышении лимита на количество уровней вложенности папок на общем диске. Общий диск пользователя не может содержать более 100 уровней вложенности папок. Подробнее см. в разделе Ограничение на глубину вложенности папок .

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "teamDriveHierarchyTooDeep",
    "message": "The shared drive hierarchy depth will exceed the limit."
   }
  ],
  "code": 403,
  "message": "The shared drive hierarchy depth will exceed the limit."
 }
}

Чтобы исправить эту ошибку:

Сообщите пользователю, что общие диски не позволяют размещать папки глубиной более 100 уровней.
Если пользователю необходимо создать еще одну вложенную папку, попросите его реорганизовать предполагаемую родительскую папку так, чтобы ее глубина была менее 100 уровней, или использовать другую родительскую папку, которая уже соответствует этому требованию.

`teamDriveMembershipRequired`

Эта ошибка возникает, когда пользователь пытается получить доступ к общему диску, к которому он не является участником. Следующий пример JSON иллюстрирует эту ошибку:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "teamDriveMembershipRequired",
        "message": "The attempted action requires shared drive membership."
      }
    ],
    "code": 403,
    "message": "The attempted action requires shared drive membership."
  }
}

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

Попросите менеджера общего диска добавить вас с соответствующими разрешениями для действия, которое вам необходимо выполнить.
Ознакомьтесь с ролями и разрешениями Диска, чтобы узнать, кто может получать доступ к общим дискам и управлять ими. Дополнительную информацию об уровнях доступа можно найти в статье «Создание общего диска» .

`teamDrivesFolderMoveInNotSupported`

Эта ошибка возникает, когда пользователь пытается переместить папку из раздела «Мой диск» на общий диск. Следующий пример JSON иллюстрирует эту ошибку:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "teamDrivesFolderMoveInNotSupported",
        "message": "Moving folders into shared drives is not supported."
      }
    ],
    "code": 403,
    "message": "Moving folders into shared drives is not supported."
  }
}

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

Переместите отдельные элементы из папки на общий диск с помощью API Диска. Установите параметр supportsAllDrives=true чтобы обозначить поддержку как «Моего диска», так и общих дисков.
Если вам необходимо переместить папку на общий диск, воспользуйтесь интерфейсом Drive. Подробнее см. в статье Перемещение папок на общие диски от имени администратора .

`teamDrivesParentLimit`

Эта ошибка возникает, когда пользователь пытается добавить более одного родительского элемента к элементу на общем диске. Следующий пример JSON иллюстрирует эту ошибку:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "teamDrivesParentLimit",
        "message": "A shared drive item must have exactly one parent."
      }
    ],
    "code": 403,
    "message": "A shared drive item must have exactly one parent."
  }
}

Чтобы исправить эту ошибку, используйте ярлыки Диска для добавления нескольких ссылок на файл. Хотя у ярлыка может быть только один родительский файл, файл ярлыка можно скопировать в дополнительные расположения. Подробнее см. в статье Создание ярлыка для файла на Диске .

`UrlLeaseLimitExceeded`

Эта ошибка возникает при попытке сохранить данные игры из Google Play через ваше приложение. Следующий пример JSON иллюстрирует эту ошибку:

{
 "error": {
  "errors": [
   {
    "domain": "usageLimits",
    "reason": "UrlLeaseLimitExceeded",
    "message": "Too many pending uploads for this snapshot. Please finish or cancel some before creating more."
   }
  ],
  "code": 403,
  "message": "Too many pending uploads for this snapshot. Please finish or cancel some before creating more."
 }
}

Чтобы исправить эту ошибку, завершите или отмените все загрузки для снимка, прежде чем создавать новые.

`userRateLimitExceeded`

Эта ошибка возникает при достижении лимита на пользователя. Это может быть ограничение в консоли Google Cloud или в бэкэнде Диска. Следующий пример JSON иллюстрирует эту ошибку:

{
 "error": {
  "errors": [
   {
    "domain": "usageLimits",
    "reason": "userRateLimitExceeded",
    "message": "User Rate Limit Exceeded"
   }
  ],
  "code": 403,
  "message": "User Rate Limit Exceeded"
 }
}

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

Увеличьте квоту для каждого пользователя в проекте Google Cloud. Для получения дополнительной информации отправьте запрос на увеличение квоты .
Если один пользователь делает многочисленные запросы от имени многих пользователей учетной записи Google Workspace, рассмотрите возможность использования учетной записи службы с делегированием на уровне домена с помощью параметра quotaUser .
Используйте экспоненциальную задержку для повторной попытки запроса.

Информацию об ограничениях API Drive см. в разделе Ограничения использования .

404 ошибки

Эти ошибки означают, что запрошенный ресурс недоступен или не существует.

`notFound`

Эта ошибка возникает, когда у пользователя нет прав на чтение файла или файл не существует. Следующий пример JSON иллюстрирует эту ошибку:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "notFound",
        "message": "File not found {fileId}"
      }
    ],
    "code": 404,
    "message": "File not found: {fileId}"
  }
}

Чтобы исправить эту ошибку:

Если файл расположен на общем диске и вы используете метод files.get , убедитесь, что параметр запроса supportsAllDrives имеет значение true .
Сообщите пользователю, что у него нет прав на чтение файла или файл не существует.
Попросите пользователя связаться с владельцем файла и запросить разрешение на доступ к файлу.

429 ошибок

Эти ошибки означают, что слишком много запросов было отправлено к API слишком быстро.

`rateLimitExceeded`

Эта ошибка возникает, когда пользователь отправил слишком много запросов за определённый промежуток времени. Следующий пример JSON иллюстрирует эту ошибку:

{
  "error": {
    "errors": [
      {
        "domain": "usageLimits",
        "reason": "rateLimitExceeded",
        "message": "Rate Limit Exceeded"
      }
    ],
    "code": 429,
    "message": "Rate Limit Exceeded"s
  }
}

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

Ошибки 500, 502, 503, 504

Эти ошибки возникают, когда при обработке запроса возникает непредвиденная ошибка сервера. Причиной их возникновения могут быть различные причины, включая наложение времени выполнения запроса на другой запрос или запрос неподдерживаемого действия, например, попытка обновить разрешения для одной страницы в Google Сайтах вместо всего сайта.

Ниже приведен список ошибок 5xx:

500 Ошибка бэкэнда
502 Неверный шлюз
503 Служба недоступна
504 Тайм-аут шлюза

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

Устранить ошибки Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Сводка кодов состояния HTTP

400 ошибок

badRequest

illegalKeepForeverModification

invalidSharingRequest

Поделиться удалось, но уведомление по электронной почте не было доставлено корректно.

Изменение ACL не разрешено для этого пользователя.

401 ошибка

authError

fileNotDownloadable

403 ошибки

activeItemCreationLimitExceeded

appNotAuthorizedToFile

cannotModifyInheritedTeamDrivePermission

dailyLimitExceeded

domainPolicy

downloadRestrictedForRevision

fileOwnerNotMemberOfTeamDrive

fileWriterTeamDriveMoveInDisabled

insufficientFilePermissions

myDriveHierarchyDepthLimitExceeded

numChildrenInNonRootLimitExceeded

rateLimitExceeded

sharingRateLimitExceeded

storageQuotaExceeded

teamDriveFileLimitExceeded

teamDriveHierarchyTooDeep

teamDriveMembershipRequired

teamDrivesFolderMoveInNotSupported

teamDrivesParentLimit

UrlLeaseLimitExceeded

userRateLimitExceeded

404 ошибки

notFound

429 ошибок

rateLimitExceeded

Ошибки 500, 502, 503, 504

Похожие темы

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

`badRequest`

`illegalKeepForeverModification`

`invalidSharingRequest`

`authError`

`fileNotDownloadable`

`activeItemCreationLimitExceeded`

`appNotAuthorizedToFile`

`cannotModifyInheritedTeamDrivePermission`

`dailyLimitExceeded`

`domainPolicy`

`downloadRestrictedForRevision`

`fileOwnerNotMemberOfTeamDrive`

`fileWriterTeamDriveMoveInDisabled`

`insufficientFilePermissions`

`myDriveHierarchyDepthLimitExceeded`

`numChildrenInNonRootLimitExceeded`

`rateLimitExceeded`

`sharingRateLimitExceeded`

`storageQuotaExceeded`

`teamDriveFileLimitExceeded`

`teamDriveHierarchyTooDeep`

`teamDriveMembershipRequired`

`teamDrivesFolderMoveInNotSupported`

`teamDrivesParentLimit`

`UrlLeaseLimitExceeded`

`userRateLimitExceeded`

`notFound`

`rateLimitExceeded`