Trang này được dịch bởi Cloud Translation API.

Giải quyết lỗi

Google Drive API trả về 2 cấp thông tin lỗi:

Mã lỗi HTTP và thông báo tiêu đề.
Một đối tượng JSON trong nội dung phản hồi có thông tin chi tiết bổ sung có thể giúp bạn xác định cách xử lý lỗi.

Các ứng dụng Google Drive phải nắm bắt và xử lý mọi lỗi có thể gặp phải khi sử dụng REST API. Hướng dẫn này cung cấp hướng dẫn về cách giải quyết các lỗi cụ thể của Drive API.

Tóm tắt mã trạng thái HTTP

Mã lỗi	Mô tả
`200 - OK`	Yêu cầu thành công (đây là phản hồi tiêu chuẩn cho các yêu cầu HTTP thành công).
`400 - Bad Request`	Không thể thực hiện yêu cầu do lỗi ứng dụng trong yêu cầu.
`401 - Unauthorized`	Yêu cầu chứa thông tin đăng nhập không hợp lệ.
`403 - Forbidden`	Yêu cầu đã được nhận và hiểu, nhưng người dùng không có quyền thực hiện yêu cầu.
`404 - Not Found`	Không tìm thấy trang được yêu cầu.
`429 - Too Many Requests`	Có quá nhiều yêu cầu gửi đến API.
`500, 502, 503, 504 - Server Errors`	Đã xảy ra lỗi ngoài dự kiến trong khi xử lý yêu cầu.

Lỗi 400

Những lỗi này có nghĩa là yêu cầu không được chấp nhận, thường là do thiếu tham số bắt buộc.

`badRequest`

Lỗi này có thể xảy ra do một trong những vấn đề sau trong mã của bạn:

Bạn chưa cung cấp một trường hoặc tham số bắt buộc.
Giá trị được cung cấp hoặc tổ hợp các trường được cung cấp là không hợp lệ.
Bạn đã cố gắng thêm một người đóng vai trò là cha mẹ trùng lặp vào một tệp trên Drive.
Bạn đã cố gắng thêm một thư mục mẹ sẽ tạo ra một chu kỳ trong biểu đồ thư mục.

Mẫu JSON sau đây là một biểu thị của lỗi này:

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

Để khắc phục lỗi này, hãy kiểm tra trường message và điều chỉnh mã cho phù hợp.

`illegalKeepForeverModification`

Lỗi này xảy ra khi bạn cố gắng đặt một bản sửa đổi tệp blob được đánh dấu là "Giữ vĩnh viễn" thành false. Mẫu JSON sau đây là một biểu thị của lỗi này:

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

Để khắc phục lỗi này, hãy xoá vĩnh viễn một bản sửa đổi tệp blob để xoá chế độ cài đặt "Giữ mãi mãi".

`invalidSharingRequest`

Lỗi này xảy ra vì một số lý do. Để xác định nguyên nhân, hãy đánh giá trường reason của JSON được trả về. Lỗi này thường xảy ra nhất do:

Chia sẻ thành công nhưng email thông báo không được gửi đúng cách.
Người dùng này không được phép thay đổi Danh sách kiểm soát truy cập (ACL).

Trường message cho biết lỗi thực tế.

Chia sẻ thành công nhưng email thông báo không được gửi đúng cách

Mẫu JSON sau đây là một biểu thị của lỗi này:

{
  "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 protected].\""
      }
    ],
    "code": 400,
    "message": "Bad Request"
  }
}

Để khắc phục lỗi này, hãy thông báo cho người dùng (người chia sẻ) rằng họ không thể chia sẻ vì không gửi được email thông báo đến địa chỉ email đích. Người dùng phải đảm bảo rằng họ có địa chỉ email chính xác và địa chỉ đó có thể nhận được email.

Người dùng này không được phép thay đổi ACL

Mẫu JSON sau đây là một biểu thị của lỗi này:

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

Để khắc phục lỗi này, hãy kiểm tra chế độ cài đặt chia sẻ của miền Google Workspace mà tệp thuộc về. Chế độ cài đặt có thể cấm chia sẻ ra bên ngoài miền hoặc không cho phép chia sẻ bộ nhớ dùng chung.

Lỗi 401

Những lỗi này có nghĩa là yêu cầu không chứa mã truy cập hợp lệ.

`authError`

Lỗi này xảy ra khi mã truy cập mà bạn đang sử dụng đã hết hạn hoặc không hợp lệ. Lỗi này cũng có thể xảy ra do thiếu quyền uỷ quyền cho các phạm vi được yêu cầu. Mẫu JSON sau đây là một biểu thị của lỗi này:

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

Để khắc phục lỗi này, hãy làm mới mã truy cập bằng mã làm mới có thời hạn sử dụng dài. Nếu không thành công, hãy hướng dẫn người dùng thực hiện quy trình OAuth, như mô tả trong phần Chọn phạm vi API Google Drive.

`fileNotDownloadable`

Lỗi này xảy ra khi bạn cố gắng sử dụng phương thức revisions.get với tham số URL alt=media trên một tài liệu Google Workspace. Mẫu JSON sau đây là một biểu thị của lỗi này:

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

Để khắc phục lỗi này, hãy thử một trong những cách sau:

Xoá tham số URL alt=media nếu bạn muốn xem siêu dữ liệu của một bản sửa đổi cụ thể, chẳng hạn như loại MIME.
Sử dụng phương thức files.export để xuất nội dung byte của tài liệu trên Google Workspace. Để biết thêm thông tin, hãy xem bài viết Xuất nội dung tài liệu trên Google Workspace.

Lỗi 403

Những lỗi này có nghĩa là bạn đã vượt quá hạn mức sử dụng hoặc người dùng không có đặc quyền phù hợp. Để xác định nguyên nhân, hãy đánh giá trường reason của JSON được trả về.

Để biết thông tin về hạn mức của Drive API, hãy tham khảo phần Hạn mức sử dụng. Để biết thông tin về giới hạn thư mục trên Drive, hãy tham khảo bài viết Giới hạn về tệp và thư mục.

`activeItemCreationLimitExceeded`

Lỗi activeItemCreationLimitExceeded xảy ra khi bạn vượt quá hạn mức về số lượng mặt hàng được tạo cho mỗi tài khoản. Mỗi người dùng có thể có tối đa 500 triệu mặt hàng do một tài khoản tạo ra. Để biết thêm thông tin, hãy xem phần Giới hạn về số lượng mặt hàng của người dùng.

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

Cách khắc phục lỗi này:

Thông báo cho người dùng rằng Drive ngăn các tài khoản tạo quá 500 triệu mục.
Nếu người dùng phải tạo các mục trong cùng một tài khoản này, hãy hướng dẫn họ xoá vĩnh viễn một số đối tượng. Nếu không, họ có thể sử dụng một tài khoản khác đã đáp ứng yêu cầu.

`appNotAuthorizedToFile`

Lỗi này xảy ra khi ứng dụng của bạn không có trong danh sách kiểm soát truy cập (ACL) của tệp. Lỗi này khiến người dùng không thể mở tệp bằng ứng dụng của bạn. Mẫu JSON sau đây là một biểu thị của lỗi này:

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

Để khắc phục lỗi này, hãy thử một trong những cách sau:

Mở trình chọn Google Drive và nhắc người dùng mở tệp.
Hướng dẫn người dùng mở tệp bằng trình đơn theo bối cảnh Mở bằng trong giao diện người dùng Drive của ứng dụng.
Sử dụng phương thức files.get để kiểm tra trường isAppAuthorized trên tài nguyên files nhằm xác minh rằng ứng dụng của bạn đã tạo hoặc mở tệp.

`cannotModifyInheritedTeamDrivePermission`

Lỗi này xảy ra khi người dùng cố gắng sửa đổi quyền được kế thừa của một mục trong bộ nhớ dùng chung. Bạn không thể xoá quyền được thừa kế khỏi một mục trong bộ nhớ dùng chung. Mẫu JSON sau đây là một biểu thị của lỗi này:

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

Để khắc phục lỗi này, người dùng phải điều chỉnh quyền đối với mục mẹ trực tiếp hoặc gián tiếp mà họ đã kế thừa. Để biết thêm thông tin, hãy xem bài viết Cách hoạt động của quyền. Bạn cũng có thể truy xuất tài nguyên permissions để xem các quyền đối với mục này trên bộ nhớ dùng chung có được thừa kế hay áp dụng trực tiếp.

`dailyLimitExceeded`

Lỗi này xảy ra khi dự án của bạn đạt đến giới hạn API. Mẫu JSON sau đây là một biểu thị của lỗi này:

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

Lỗi này xuất hiện khi chủ sở hữu ứng dụng đã đặt hạn mức để giới hạn mức sử dụng một tài nguyên cụ thể. Để khắc phục lỗi này, hãy xoá mọi giới hạn sử dụng đối với hạn mức "Số lượng truy vấn mỗi ngày".

`domainPolicy`

Lỗi này xảy ra khi chính sách cho miền của người dùng không cho phép ứng dụng của bạn truy cập vào Drive. Mẫu JSON sau đây là một biểu thị của lỗi này:

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

Cách khắc phục lỗi này:

Thông báo cho người dùng rằng miền này không cho phép ứng dụng của bạn truy cập vào các tệp trong Drive.
Hướng dẫn người dùng liên hệ với quản trị viên miền để yêu cầu quyền truy cập cho ứng dụng của bạn.

`downloadRestrictedForRevision`

Lỗi này xảy ra khi người dùng không thể tải một bản sửa đổi tệp blob xuống. Mẫu JSON sau đây là một biểu thị của lỗi này:

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

Để khắc phục lỗi này, hãy thông báo cho người dùng rằng cách duy nhất để tải các bản sửa đổi tệp blob xuống là nếu các bản sửa đổi đó được đánh dấu là "Lưu giữ vĩnh viễn". Để biết thêm thông tin, hãy xem phần Chỉ định phiên bản cần lưu để tránh bị xoá tự động.

`fileOwnerNotMemberOfTeamDrive`

Lỗi này xảy ra khi bạn cố gắng di chuyển một tệp vào bộ nhớ dùng chung và chủ sở hữu tệp không phải là thành viên. Mẫu JSON sau đây là một biểu thị của lỗi này:

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

Cách khắc phục lỗi này:

Thêm thành viên vào bộ nhớ dùng chung bằng role=owner. Để biết thêm thông tin, hãy xem bài viết Chia sẻ tệp, thư mục và ổ đĩa.
Thêm tệp vào bộ nhớ dùng chung. Để biết thêm thông tin, hãy xem phần Tạo và điền sẵn thông tin vào thư mục.

`fileWriterTeamDriveMoveInDisabled`

Lỗi này xảy ra khi quản trị viên miền chưa cho phép người dùng có role=writer di chuyển các mục vào bộ nhớ dùng chung. Người dùng đang cố gắng di chuyển các mục có ít quyền hơn so với quyền được phép trên bộ nhớ dùng chung đích. Mẫu JSON sau đây là một biểu thị của lỗi này:

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

Để khắc phục lỗi này, hãy sử dụng cùng một tài khoản người dùng quản trị trên cả ổ đĩa dùng chung nguồn và đích.

`insufficientFilePermissions`

Lỗi này xảy ra khi người dùng không có quyền ghi vào một tệp và ứng dụng của bạn đang cố gắng sửa đổi tệp đó. Mẫu JSON sau đây là một biểu thị của lỗi này:

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

Để khắc phục lỗi này, hãy hướng dẫn người dùng liên hệ với chủ sở hữu tệp và yêu cầu cấp quyền chỉnh sửa. Bạn cũng có thể kiểm tra cấp truy cập của người dùng trong siêu dữ liệu do phương thức files.get truy xuất và hiển thị giao diện người dùng chỉ đọc khi thiếu quyền.

`myDriveHierarchyDepthLimitExceeded`

Lỗi myDriveHierarchyDepthLimitExceeded xảy ra khi bạn vượt quá giới hạn về số lượng cấp thư mục lồng nhau. Phần Drive của tôi của người dùng không thể chứa hơn 100 cấp thư mục lồng nhau. Để biết thêm thông tin, hãy xem bài viết Giới hạn chiều sâu của thư mục.

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

Cách khắc phục lỗi này:

Thông báo cho người dùng rằng Drive không cho phép đặt thư mục có hơn 100 cấp.
Nếu người dùng phải tạo một thư mục lồng nhau khác, hãy hướng dẫn họ sắp xếp lại thư mục mẹ dự kiến sao cho có ít hơn 100 cấp hoặc sử dụng một thư mục mẹ khác đã đáp ứng yêu cầu.

`numChildrenInNonRootLimitExceeded`

Lỗi này xảy ra khi số lượng thư mục con (thư mục, tệp và lối tắt) của một thư mục vượt quá giới hạn. Có giới hạn 500.000 mục đối với thư mục, tệp và lối tắt nằm trực tiếp trong một thư mục. Các mục được lồng trong thư mục con không được tính vào giới hạn 500.000 mục này. Để biết thêm thông tin về giới hạn thư mục trên Drive, hãy tham khảo bài viết Giới hạn thư mục trong Google Drive.

Mẫu JSON sau đây là một biểu thị của lỗi này:

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

Để khắc phục lỗi này, hãy thử một trong những cách sau:

Thông báo cho người dùng rằng Drive ngăn chặn các thư mục có hơn 500.000 mục.
Nếu người dùng phải thêm nhiều mục vào thư mục đầy, hãy hướng dẫn họ sắp xếp lại thư mục để chứa ít hơn 500.000 mục hoặc sử dụng một thư mục tương tự đã chứa ít mục hơn.

`rateLimitExceeded`

Lỗi này xảy ra khi dự án đạt đến hạn mức. Giới hạn này sẽ khác nhau tuỳ thuộc vào loại yêu cầu. Mẫu JSON sau đây là một biểu thị của lỗi này:

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

Để khắc phục lỗi này, hãy thử một trong những cách sau:

Tăng hạn mức cho mỗi người dùng trong dự án Google Cloud. Để biết thêm thông tin, hãy yêu cầu tăng hạn mức.
Yêu cầu hàng loạt để kết hợp nhiều lệnh gọi API thành một yêu cầu HTTP.
Sử dụng thuật toán thời gian đợi luỹ thừa để thử lại yêu cầu.

`sharingRateLimitExceeded`

Lỗi này xảy ra khi người dùng đạt đến giới hạn chia sẻ và thường liên quan đến giới hạn email. Mẫu JSON sau đây là một biểu thị của lỗi này:

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

Cách khắc phục lỗi này:

Không gửi email khi chia sẻ số lượng lớn tệp.
Nếu một người dùng đang thực hiện nhiều yêu cầu thay mặt cho nhiều người dùng của một tài khoản Google Workspace, hãy cân nhắc sử dụng tài khoản dịch vụ có uỷ quyền trên toàn miền bằng cách sử dụng tham số quotaUser.

`storageQuotaExceeded`

Lỗi này xảy ra khi người dùng đạt đến hạn mức bộ nhớ. Mẫu JSON sau đây là một biểu thị của lỗi này:

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

Cách khắc phục lỗi này:

Xem hạn mức bộ nhớ của tài khoản Drive. Để biết thêm thông tin, hãy tham khảo bài viết Hạn mức bộ nhớ và hạn mức tải lên của Google Workspace.
Quản lý bộ nhớ trong Drive, Gmail và Google Photos.
Mua thêm bộ nhớ trên Google.

`teamDriveFileLimitExceeded`

Lỗi này xảy ra khi người dùng cố gắng vượt quá giới hạn nghiêm ngặt về số lượng mục trên một ổ đĩa dùng chung. Mỗi thư mục trong bộ nhớ dùng chung của người dùng có giới hạn là 500.000 mục, bao gồm cả tệp, thư mục và lối tắt. Hạn mức này dựa trên số lượng mục chứ không phải mức sử dụng bộ nhớ. Để biết thêm thông tin, hãy xem bài viết Hạn mức bộ nhớ dùng chung trong Google Drive.

Mẫu JSON sau đây là một biểu thị của lỗi này:

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

Để khắc phục lỗi này, hãy giảm số lượng mục trong bộ nhớ dùng chung. Bộ nhớ dùng chung có quá nhiều tệp có thể dẫn đến việc khó sắp xếp và tìm kiếm.

`teamDriveHierarchyTooDeep`

Lỗi teamDriveHierarchyTooDeep xảy ra khi bạn vượt quá giới hạn về số lượng cấp thư mục lồng nhau trong bộ nhớ dùng chung. Bộ nhớ dùng chung của người dùng không thể chứa hơn 100 cấp thư mục lồng nhau. Để biết thêm thông tin, hãy xem phần Giới hạn về độ sâu của thư mục.

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

Cách khắc phục lỗi này:

Thông báo cho người dùng rằng bộ nhớ dùng chung ngăn việc đặt thư mục có hơn 100 cấp.
Nếu người dùng phải tạo một thư mục lồng nhau khác, hãy hướng dẫn họ sắp xếp lại thư mục mẹ dự kiến sao cho có ít hơn 100 cấp hoặc sử dụng một thư mục mẹ khác đã đáp ứng yêu cầu.

`teamDriveMembershipRequired`

Lỗi này xảy ra khi người dùng cố gắng truy cập vào một bộ nhớ dùng chung mà họ không phải là thành viên. Mẫu JSON sau đây là một biểu thị của lỗi này:

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

Để khắc phục lỗi này, hãy thử một trong những cách sau:

Yêu cầu người quản lý bộ nhớ dùng chung cấp cho bạn quyền phù hợp để thực hiện thao tác cần thiết.
Xem vai trò và quyền của Drive để tìm hiểu những người có thể truy cập và quản lý bộ nhớ dùng chung. Bạn cũng có thể xem thêm thông tin về các cấp truy cập tại phần Tạo bộ nhớ dùng chung.

`teamDrivesFolderMoveInNotSupported`

Lỗi này xảy ra khi người dùng cố gắng di chuyển một thư mục từ Drive của tôi vào bộ nhớ dùng chung. Mẫu JSON sau đây là một biểu thị của lỗi này:

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

Để khắc phục lỗi này, hãy thử một trong những cách sau:

Di chuyển từng mục trong thư mục vào bộ nhớ dùng chung bằng Drive API. Đặt tham số supportsAllDrives=true để biểu thị việc hỗ trợ cả Drive của tôi và bộ nhớ dùng chung.
Nếu bạn phải di chuyển thư mục vào bộ nhớ dùng chung, hãy sử dụng giao diện người dùng Drive. Để biết thêm thông tin, hãy xem bài viết Di chuyển thư mục vào bộ nhớ dùng chung với tư cách quản trị viên.

`teamDrivesParentLimit`

Lỗi này xảy ra khi người dùng cố gắng thêm nhiều thư mục mẹ vào một mục trong bộ nhớ dùng chung. Mẫu JSON sau đây là một biểu thị của lỗi này:

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

Để khắc phục lỗi này, hãy dùng lối tắt trên Drive để thêm nhiều đường liên kết vào một tệp. Mặc dù một lối tắt chỉ có thể có một thư mục gốc, nhưng bạn có thể sao chép tệp lối tắt vào các vị trí khác. Để biết thêm thông tin, hãy xem bài viết Tạo lối tắt đến một tệp trên Drive.

`UrlLeaseLimitExceeded`

Lỗi này xảy ra khi bạn cố gắng lưu dữ liệu trò chơi trên Google Play thông qua ứng dụng của mình. Mẫu JSON sau đây là một biểu thị của lỗi này:

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

Để khắc phục lỗi này, hãy hoàn tất hoặc huỷ mọi hoạt động tải lên cho một ảnh chụp nhanh trước khi tạo thêm.

`userRateLimitExceeded`

Lỗi này xảy ra khi bạn đạt đến giới hạn trên mỗi người dùng. Đây có thể là một giới hạn của bảng điều khiển Google Cloud hoặc một giới hạn của phần phụ trợ Drive. Mẫu JSON sau đây là một biểu thị của lỗi này:

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

Để khắc phục lỗi này, hãy thử một trong những cách sau:

Tăng hạn mức cho mỗi người dùng trong dự án Google Cloud. Để biết thêm thông tin, hãy yêu cầu tăng hạn mức.
Nếu một người dùng đang thực hiện nhiều yêu cầu thay mặt cho nhiều người dùng của một tài khoản Google Workspace, hãy cân nhắc sử dụng tài khoản dịch vụ có uỷ quyền trên toàn miền bằng cách sử dụng tham số quotaUser.
Sử dụng thuật toán thời gian đợi luỹ thừa để thử lại yêu cầu.

Để biết thông tin về hạn mức của Drive API, hãy tham khảo phần Hạn mức sử dụng.

Lỗi 404

Những lỗi này có nghĩa là bạn không truy cập được vào tài nguyên được yêu cầu hoặc tài nguyên đó không tồn tại.

`notFound`

Lỗi này xảy ra khi người dùng không có quyền đọc một tệp hoặc tệp đó không tồn tại. Mẫu JSON sau đây là một biểu thị của lỗi này:

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

Cách khắc phục lỗi này:

Nếu tệp nằm trong bộ nhớ dùng chung và bạn đang sử dụng phương thức files.get, hãy đảm bảo rằng tham số truy vấn supportsAllDrives được đặt thành true.
Thông báo cho người dùng rằng họ không có quyền đọc tệp hoặc tệp không tồn tại.
Hướng dẫn người dùng liên hệ với chủ sở hữu tệp và yêu cầu cấp quyền truy cập vào tệp.

Lỗi 429

Những lỗi này có nghĩa là bạn đã gửi quá nhiều yêu cầu đến API trong thời gian quá ngắn.

`rateLimitExceeded`

Lỗi này xảy ra khi người dùng gửi quá nhiều yêu cầu trong một khoảng thời gian nhất định. Mẫu JSON sau đây là một biểu thị của lỗi này:

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

Để khắc phục lỗi này, hãy sử dụng thời gian đợi luỹ thừa để thử lại yêu cầu.

Lỗi 500, 502, 503, 504

Những lỗi này xảy ra khi có lỗi máy chủ không mong muốn trong quá trình xử lý yêu cầu. Nhiều vấn đề có thể gây ra các lỗi này, bao gồm cả thời gian của một yêu cầu trùng với một yêu cầu khác hoặc yêu cầu cho một hành động không được hỗ trợ, chẳng hạn như cố gắng cập nhật quyền cho một trang duy nhất trong Google Sites thay vì toàn bộ trang web.

Sau đây là danh sách các lỗi 5xx:

500 Lỗi trong chương trình phụ trợ
502 Cổng không hợp lệ
503 Không có dịch vụ
504 Hết thời gian chờ cổng

Để khắc phục lỗi này, hãy sử dụng thời gian đợi luỹ thừa để thử lại yêu cầu.

Giải quyết lỗi

Tóm tắt mã trạng thái HTTP

Lỗi 400

badRequest

illegalKeepForeverModification

invalidSharingRequest

Chia sẻ thành công nhưng email thông báo không được gửi đúng cách

Người dùng này không được phép thay đổi ACL

Lỗi 401

authError

fileNotDownloadable

Lỗi 403

activeItemCreationLimitExceeded

appNotAuthorizedToFile

cannotModifyInheritedTeamDrivePermission

dailyLimitExceeded

domainPolicy

downloadRestrictedForRevision

fileOwnerNotMemberOfTeamDrive

fileWriterTeamDriveMoveInDisabled

insufficientFilePermissions

myDriveHierarchyDepthLimitExceeded

numChildrenInNonRootLimitExceeded

rateLimitExceeded

sharingRateLimitExceeded

storageQuotaExceeded

teamDriveFileLimitExceeded

teamDriveHierarchyTooDeep

teamDriveMembershipRequired

teamDrivesFolderMoveInNotSupported

teamDrivesParentLimit

UrlLeaseLimitExceeded

userRateLimitExceeded

Lỗi 404

notFound

Lỗi 429

rateLimitExceeded

Lỗi 500, 502, 503, 504

Chủ đề có liên quan

`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`