Giải quyết lỗi

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

  • Mã lỗi HTTP và thông báo ở tiêu đề.
  • Đố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 sẽ nắm bắt và xử lý tất cả các lỗi có thể gặp phải khi sử dụng API REST. Hướng dẫn này đưa ra hướng dẫn về cách giải quyết các lỗi API Drive cụ thể.

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 có lỗi ứng dụng khách trong yêu cầu.
401 - Unauthorized Yêu cầu chứa thông tin xác thực 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 đến API.
500, 502, 503, 504 - Server Errors Phát sinh lỗi không mong muốn trong khi xử lý yêu cầu.

Lỗi 400

Những lỗi này khiến 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 đây trong mã của bạn:

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

Mẫu JSON sau đây thể hiện 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.

invalidSharingRequest

Lỗi này xảy ra vì một vài 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.
  • Thay đổi Danh sách kiểm soát truy cập (ACL) không được phép cho người dùng này.

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 thể hiện 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@domain.com.\""
      }
    ],
    "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ẻ) họ không thể chia sẻ vì không thể gửi email thông báo đến địa chỉ email đích. Chiến lược phát hành đĩa đơn người dùng cần đảm bảo rằng họ có địa chỉ email chính xác và địa chỉ đó có thể nhận email.

Người dùng này không được phép thay đổi Danh sách kiểm soát quyền truy cập (ACL)

Mẫu JSON sau đây thể hiện 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 xem phần chia sẻ cài đặt của miền Google Workspace chứa tệp. Các chế độ cài đặt có thể cấm chia sẻ ra bên ngoài miền hoặc chia sẻ bộ nhớ dùng chung có thể không bị được phép.

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 uỷ quyền cho các phạm vi được yêu cầu. Mẫu JSON sau đây thể hiện 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 dài hạn. Nếu thao tác này không thành công, hãy hướng dẫn người dùng thông qua quy trình OAuth, như được mô tả trong phần Chọn Các phạm vi của API Google Drive.

Lỗi 403

Những lỗi này có nghĩa là đã vượt quá hạn mức sử dụng hoặc người dùng không có những đặc quyền chính xác. Để 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 API Drive, hãy tham khảo bài viết Giới hạn sử dụng. Để biết thông tin về thư mục Drive hãy tham khảo Giới hạn đối với tệp và thư mục.

activeItemCreationLimitExceeded

Lỗi activeItemCreationLimitExceeded xảy ra khi giới hạn số lượng đã vượt quá số mục đượ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ục được tạo bởi một tài khoản. Để biết thêm thông tin, hãy xem bài viết Mục người dùng tối đa.

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

  1. Thông báo cho người dùng rằng Drive không cho phép tạo tài khoản hơn 500 triệu mục.

  2. 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ó trên Danh sách kiểm soát quyền truy cập (ACL) cho tệp. Lỗi này ngăn người dùng mở tệp bằng ứng dụng của bạn. Mẫu JSON sau là 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ử bất kỳ cách nào sau đây:

  • Mở bộ chọn của 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 Drive Giao diện người dùng của ứng dụng.
  • Sử dụng phương thức files.get để hãy kiểm tra trường isAppAuthorized trên files để xác minh rằng ứng dụng 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 các quyền được kế thừa của một mục trong bộ nhớ dùng chung. Không thể xoá quyền được kế thừa khỏi một mục trong bộ nhớ dùng chung. Mẫu JSON sau đây thể hiện 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 truy cập trực tiếp hoặc gián tiếp mục gốc mà chúng được kế thừa từ đó. Để biết thêm thông tin, hãy xem Quyền truyền tải. Bạn có thể cũng truy xuất permissions.permissionDetails tài nguyên để xem các quyền đối với mục trên bộ nhớ dùng chung này có được kế thừa hay không hoặc được áp dụng trực tiếp.

dailyLimitExceeded

Lỗi này xảy ra khi đạt đến giới hạn API cho dự án của bạn. Nội dung sau đây Mẫu JSON biểu thị 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 giới hạn hạn mức thành giới hạn việ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 cho "Truy vấn mỗi ngày" hạn mức.

domainPolicy

Lỗi này xảy ra khi chính sách miền của người dùng không cho phép truy cập vào Thúc đẩy ứng dụng của bạn. Mẫu JSON sau đây là cách trình bày 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:

  1. Thông báo cho người dùng rằng miền không cho phép ứng dụng của bạn truy cập vào tệp trong Drive.
  2. 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.

fileOwnerNotMemberOfTeamDrive

Lỗi này xảy ra khi cố 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à cách thể hiện điều này lỗi:

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

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

  2. 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 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 một bộ nhớ dùng chung. Người dùng cố gắng di chuyển các mục có ít quyền hơn mức cho phép trên bộ nhớ dùng chung đích. Chiến lược phát hành đĩa đơn mẫu JSON sau đây biểu thị 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ị viên trên cả hai nguồn và bộ nhớ dùng chung đí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ố sửa đổi tệp. Mẫu JSON sau đây là mô tả 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 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 được truy xuất bằng phương thức files.get và hiển thị giao diện người dùng chỉ có thể đọc khi thiếu quyền.

myDriveHierarchyDepthLimitExceeded

Lỗi myDriveHierarchyDepthLimitExceeded xảy ra khi giới hạn cho đã vượt quá số lượng cấp độ thư mục lồng nhau. Drive không thể chứa hơn 100 cấp của các thư mục lồng nhau. Cho thông tin khác, hãy xem Folder-depth tối đa.

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

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

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

numChildrenInNonRootLimitExceeded

Lỗi này xảy ra khi giới hạn số lượng thư mục con (thư mục, tệp và lối tắt). Giới hạn 500.000 mục cho các thư mục, tệp và lối tắt ngay 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, tham khảo Giới hạn thư mục trong Google Drive.

Mẫu JSON sau đây thể hiện 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ử bất kỳ cách nào sau đây:

  • Thông báo cho người dùng rằng Drive sẽ chặn những thư mục có hơn 500.000 mục.
  • Nếu người dùng phải thêm các mục khác vào toàn bộ thư mục, 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ục tương tự đã chứa ít mục hơn.

rateLimitExceeded

Lỗi này xảy ra khi đã đạt đến giới hạn số lượng yêu cầu của dự án. Giới hạn này khác nhau tuỳ thuộc vào loại yêu cầu. Mẫu JSON sau đây là mô tả 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ử bất kỳ cách nào sau đây:

sharingRateLimitExceeded

Lỗi này xảy ra khi người dùng đạt đến giới hạn chia sẻ và thường được liên kết email. Mẫu JSON sau đây là cách thể hiện điều này lỗi:

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

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

storageQuotaExceeded

Lỗi này xảy ra khi người dùng đạt đến hạn mức bộ nhớ. Nội dung sau đây Mẫu JSON biểu thị 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:

  1. Xem lại hạn mức bộ nhớ của tài khoản Drive. Để biết thêm thông tin, tham khảo bài viết Bộ nhớ và cách tải lên của Google Workspace .

  2. Quản lý tệp trong Google Drive bộ nhớ.

  3. Mua thêm Google bộ nhớ.

teamDriveFileLimitExceeded

Lỗi này xảy ra khi người dùng cố gắng vượt quá giới hạn mặt hàng nghiêm ngặt trên một bộ nhớ dùng chung. Mỗi thư mục trong bộ nhớ dùng chung của người dùng chỉ được có tối đa 500.000 mục, bao gồm các tệp, thư mục và lối tắt. Giới hạn này là dựa trên số lượng mặt hàng, chứ không phải dựa trên số lượng mặt hàng 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 thể hiện 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ể gây khó khăn cho việc sắp xếp và tìm kiếm.

teamDriveHierarchyTooDeep

Lỗi teamDriveHierarchyTooDeep xảy ra khi giới hạn số lượng đã vượt quá cấp độ thư mục lồng 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 Giới hạn chiều 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:

  1. Thông báo cho người dùng rằng bộ nhớ dùng chung không cho phép đặt thư mục lớn hơn 100 cấp độ.
  2. Nếu người dùng phải tạo một thư mục lồng khác, hãy hướng dẫn họ sắp xếp lại thư mục mẹ dự kiến có ít hơn 100 cấp độ hoặc sử dụng 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 bộ nhớ dùng chung mà họ không phải thành viên. Mẫu JSON sau đây thể hiện 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ử bất kỳ cách nào sau đây:

  1. Hãy yêu cầu người quản lý bộ nhớ dùng chung thêm bạn cùng với cho hành động mà bạn phải thực hiện.

  2. Xem lại vai trò và để tìm hiểu xem ai 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 Tạo một Drive.

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ừ Ổ vào bộ nhớ dùng chung. Mẫu JSON sau đây là mô tả 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ử bất kỳ cách nào sau đây:

  • Di chuyển từng mục từ thư mục này vào bộ nhớ dùng chung bằng API Drive. Đặt tham số supportsAllDrives=true để biểu thị khả năng 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 sang một bộ nhớ dùng chung, hãy sử dụng Giao diện người dùng của Drive. Để biết thêm thông tin, hãy xem phần Di chuyển thư mục vào thư mục dùng chung Drive trong vai trò 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 cấp độ gốc vào một mục trong bộ nhớ dùng chung. Mẫu JSON sau đây thể hiện 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 sử dụng phím tắt trên Drive để thêm nhiều đường liên kết vào một . Mặc dù một lối tắt chỉ có thể chứa một tệp cha mẹ, nhưng tệp lối tắt có thể sao chép sang các vị trí khác. Để biết thêm thông tin, hãy xem phần Tạo lối tắt đến một tệp trên Drive.

UrlLeaseLimitExceeded

Lỗi này xảy ra khi cố gắng lưu dữ liệu trò chơi trên Google Play thông qua . Mẫu JSON sau đây thể hiện 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 tệp tải lên để chụp ảnh chụp nhanh trước khi tạo khác.

userRateLimitExceeded

Lỗi này xảy ra khi đã đạt đến giới hạn trên mỗi người dùng. Đây có thể là hạn mức trong bảng điều khiển Google Cloud hoặc hạn mức trong Drive phần phụ trợ. Mẫu JSON sau đây thể hiện 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ử bất kỳ cách nào sau đây:

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

Lỗi 404

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

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 thể hiện 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:

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

Lỗi 429

Những lỗi này có nghĩa là có quá nhiều yêu cầu được gửi đến API quá nhanh.

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 lượng thời gian. Mẫu JSON sau đây thể hiện 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 hàm số mũ thời gian đợi để thử lại yêu cầu.

Lỗi 500, 502, 503, 504

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

Dưới đây là danh sách các lỗi 5xx:

  • 500 Lỗi phụ trợ
  • 502 Cổng vào không hợp lệ
  • 503 Không có dịch vụ
  • 504 Cổng vào không nhận được phản hồi kịp thời trong thời gian chờ

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