이 페이지는 Cloud Translation API를 통해 번역되었습니다.

오류 해결

Google Drive API는 다음 두 가지 수준의 오류 정보를 반환합니다.

HTTP 오류 코드 및 헤더 메시지
응답 본문의 JSON 객체로, 추가 세부정보와 오류 처리 방법을 결정합니다

Google Drive 앱은 발생할 수 있는 모든 오류를 포착하고 처리해야 합니다. (REST 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`

이 오류는 코드에서 다음과 같은 문제 중 하나로 인해 발생할 수 있습니다.

필수 입력란 또는 매개변수가 제공되지 않았습니다.
제공된 값 또는 제공된 필드의 조합이 잘못되었습니다.
Drive 파일에 중복된 상위 항목을 추가하려고 했습니다.
디렉터리 그래프에 주기를 만드는 상위 요소를 추가하려고 했습니다.

다음 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 필드를 확인하고 그에 따라 코드를 조정하세요.

`invalidSharingRequest`

이 오류는 여러 가지 이유로 발생합니다. 원인을 파악하려면 반환된 JSON의 reason 필드입니다. 이 오류는 일반적으로 다음과 같은 이유로 발생합니다.

공유에 성공했지만 알림 이메일이 제대로 전송되지 않았습니다.
액세스 제어 목록 (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"
  }
}

이 오류를 해결하려면 공유 설정 권한이 있습니다. 설정이 도메인 외부에 공유하거나 공유 드라이브를 사용하지 못할 수 있음 있습니다.

401 오류

이러한 오류는 요청에 유효한 액세스 토큰이 포함되어 있지 않음을 의미합니다.

`authError`

이 오류는 사용 중인 액세스 토큰이 만료되었거나 잘못되었습니다. 이 오류는 지정할 수 있습니다 다음 JSON 샘플은 이 오류를 표현한 것입니다.

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

이 오류를 해결하려면 장기 갱신 토큰을 사용하여 액세스 토큰을 새로고침하세요. 실패할 경우 선택 Google Drive API 범위

403 오류

이 오류는 사용량 한도를 초과했거나 사용자에게 올바른 권한이 있는지 확인하세요 원인을 파악하려면 reason 필드를 평가합니다. JSON을 반환합니다.

Drive API 한도에 대한 자세한 내용은 사용량 한도를 참고하세요. Drive 폴더 관련 정보 자세한 내용은 파일 및 폴더 한도를 참고하세요.

`activeItemCreationLimitExceeded`

개수 제한인 경우 activeItemCreationLimitExceeded 오류가 발생합니다. 계정당 생성된 개의 아이템을 초과했습니다. 각 사용자는 최대 500개의 100만 개 항목이 포함됩니다. 자세한 내용은 사용자-항목 한도를 준수합니다.

{
 "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."
 }
}

이 오류를 수정하는 방법은 다음과 같습니다.

사용자에게 Drive에서 계정을 만들 수 없다고 알림 5억 개 이상의 항목을 만들 수 있습니다.
사용자가 동일한 계정에서 항목을 만들어야 하는 경우 다음을 수행하도록 안내합니다. 일부 객체를 영구적으로 삭제합니다. 그렇지 않으면 다른 계정을 사용할 수 있습니다. 확인할 수 있습니다

`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 Drive 선택 도구 열기 사용자에게 파일을 열라는 메시지를 표시합니다.
사용자에게 Drive에서 연결 프로그램 컨텍스트 메뉴를 사용하여 파일을 열라고 안내합니다. 앱의 UI입니다.
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.permissionDetails 리소스를 확인하여 이 공유 드라이브 항목에 대한 권한이 상속되는지 확인 직접 적용할 수도 있습니다

`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."
  }
}

이 오류를 수정하는 방법은 다음과 같습니다.

사용자에게 도메인에서 앱이 드라이브.
사용자에게 도메인 관리자에게 연락하여 에 대한 액세스를 요청하도록 안내합니다. 있습니다.

`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 메서드를 호출하고 읽기 전용 UI로 전환할 수 있습니다.

`myDriveHierarchyDepthLimitExceeded`

myDriveHierarchyDepthLimitExceeded 오류는 중첩된 폴더 수준의 수를 초과했습니다. 사용자의 Drive에는 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/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/drive/api/guides/handle-errors#nested-folder-levels."
 }
}

이 오류를 수정하는 방법은 다음과 같습니다.

사용자에게 Drive에서 폴더를 100개 레벨로 구성됩니다.
사용자가 다른 중첩 폴더를 만들어야 하는 경우 재구성하도록 안내합니다. 상위 폴더를 100레벨 미만으로 설정하거나 이미 요구사항을 충족하는 다른 상위 폴더를 생성해야 합니다

`numChildrenInNonRootLimitExceeded`

이 오류는 폴더의 하위 항목 (폴더, 폴더, 폴더)에 대한 파일, 바로가기)가 초과되었습니다. 상품 한도는 50만 개로 폴더, 파일, 바로가기를 폴더에 바로 추가할 수 있습니다. 하위 폴더에 중첩된 항목 500,000개의 항목 한도에 포함되지 않습니다. 자세한 내용은 Drive 폴더 한도는 Google Drive를 사용합니다.

다음 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."
 }
}

이 오류를 해결하려면 다음 중 하나를 시도해 보세요.

사용자에게 Drive에서 항목을 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 호출
지수 백오프를 사용하여 요청을 수행합니다.

`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."
 }
}

이 오류를 수정하는 방법은 다음과 같습니다.

Drive 계정 스토리지 한도를 검토하세요. 자세히 알아보기 자세한 내용은 Google Workspace 저장용량 및 업로드 한도를 준수합니다.
Google Drive에서 파일 관리하기 스토리지를 참조하세요.
추가 Google 구입 스토리지를 참조하세요.

`teamDriveFileLimitExceeded`

이 오류는 사용자가 계정에서 엄격한 상품 한도를 초과하려고 할 때 발생합니다. 공유할 수 있습니다. 사용자의 공유 드라이브에 있는 각 폴더의 항목은 500,000개로 제한됩니다. 파일, 폴더, 바로가기 등입니다. 이 한도는 상품이 아닌 상품 수를 기준으로 합니다. 스토리지 사용량 자세한 내용은 공유 드라이브 한도를 참고하세요. Google Drive를 사용합니다.

다음 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."
  }
}

이 오류를 해결하려면 다음 중 하나를 시도해 보세요.

공유 드라이브 관리자에게 적절한 Google 계정을 추가해 달라고 요청하세요. 권한을 부여할 수 있습니다.
드라이브의 역할 및 액세스 및 관리할 수 있는 사용자 확인 공유 드라이브를 탭합니다. 액세스 수준에 대한 추가 정보도 확인할 수 있습니다. 공유된 드라이브로 이동합니다.

`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."
  }
}

이 오류를 해결하려면 다음 중 하나를 시도해 보세요.

공유 드라이브로 개별 항목을 이동하려면 Drive API supportsAllDrives=true 매개변수를 설정하여 내 드라이브와 공유 드라이브를 모두 지원합니다.
폴더를 공유 드라이브로 이동해야 하는 경우 Drive UI 자세한 내용은 공유 폴더로 폴더 이동하기를 참고하세요. 드라이브를 관리할 수 있습니다.

`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."
  }
}

이 오류를 해결하려면 Drive 단축키를 사용하여 파일에서 참조됩니다. 바로가기에는 하나의 상위 요소만 있을 수 있지만, 바로가기 파일은 복사됩니다. 자세한 내용은 문서 만들기 드라이브 파일 바로가기

`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 콘솔에서 한도 또는 Drive의 한도 사용할 수 있습니다 다음 JSON 샘플은 이 오류를 표현한 것입니다.

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

이 오류를 해결하려면 다음 중 하나를 시도해 보세요.

Google Cloud 프로젝트에서 사용자당 할당량을 늘립니다. 자세한 내용은 할당량 증가를 요청할 수 있습니다.

한 사용자가 사이트의 많은 사용자를 대신하여 여러 요청을 하는 경우 Google Workspace 계정은 도메인 전체의 서비스 계정을 위임 quotaUser 사용 매개변수입니다.
지수 백오프를 사용하여 요청을 수행합니다.

Drive API 한도에 대한 자세한 내용은 사용량 한도를 참고하세요.

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 Sites에서 단일 페이지에 대한 권한만 업데이트하는 것이 아니라 확인할 수 있습니다

5xx 오류 목록은 다음과 같습니다.

500 백엔드 오류
502 잘못된 게이트웨이
503 서비스를 사용할 수 없음
504 게이트웨이 시간 초과

이 오류를 수정하려면 지수 백오프: 요청을 재시도합니다.

오류 해결

HTTP 상태 코드 요약

400 오류

badRequest

invalidSharingRequest

공유에 성공했지만 알림 이메일이 제대로 전송되지 않음

이 사용자는 ACL 변경이 허용되지 않습니다.

401 오류

authError

403 오류

activeItemCreationLimitExceeded

appNotAuthorizedToFile

cannotModifyInheritedTeamDrivePermission

dailyLimitExceeded

domainPolicy

fileOwnerNotMemberOfTeamDrive

fileWriterTeamDriveMoveInDisabled

insufficientFilePermissions

myDriveHierarchyDepthLimitExceeded

numChildrenInNonRootLimitExceeded

rateLimitExceeded

sharingRateLimitExceeded

storageQuotaExceeded

teamDriveFileLimitExceeded

teamDriveHierarchyTooDeep

teamDriveMembershipRequired

teamDrivesFolderMoveInNotSupported

teamDrivesParentLimit

UrlLeaseLimitExceeded

userRateLimitExceeded

404 오류

notFound

429 오류

rateLimitExceeded

500, 502, 503, 504 오류

관련 주제

`badRequest`

`invalidSharingRequest`

`authError`

`activeItemCreationLimitExceeded`

`appNotAuthorizedToFile`

`cannotModifyInheritedTeamDrivePermission`

`dailyLimitExceeded`

`domainPolicy`

`fileOwnerNotMemberOfTeamDrive`

`fileWriterTeamDriveMoveInDisabled`

`insufficientFilePermissions`

`myDriveHierarchyDepthLimitExceeded`

`numChildrenInNonRootLimitExceeded`

`rateLimitExceeded`

`sharingRateLimitExceeded`

`storageQuotaExceeded`

`teamDriveFileLimitExceeded`

`teamDriveHierarchyTooDeep`

`teamDriveMembershipRequired`

`teamDrivesFolderMoveInNotSupported`

`teamDrivesParentLimit`

`UrlLeaseLimitExceeded`

`userRateLimitExceeded`

`notFound`

`rateLimitExceeded`