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

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ó cá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 phát hiện và xử lý tất cả các lỗi có thể gặp phải khi sử dụng API REST. Tài liệu này hướng dẫn cách giải quyết các lỗi cụ thể về API Drive.

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

Mã lỗi	Nội dung 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 tiếp 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`	Lỗi không mong muốn sẽ phát sinh 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 thông số bắt buộc.

`badRequest`

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

Bạn chưa cung cấp 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 đã cung cấp không hợp lệ.
Bạn đã cố thêm một tệp mẹ trùng lặp vào một tệp trên Drive.
Bạn đã cố thêm thư mục mẹ sẽ tạo ra một chu kỳ trong biểu đồ thư mục.

Mẫu JSON sau đây là minh hoạ cho 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 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 chưa được gửi chính xác.
Không được phép thay đổi Danh sách kiểm soát quyền truy cập (ACL) đối với 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 chưa được gửi chính xác

Mẫu JSON sau đây là minh hoạ cho 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 tới địa chỉ email đích. Người dùng phải đảm bảo họ có địa chỉ email chính xác và địa chỉ đó có thể nhận email.

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

Mẫu JSON sau đây là minh hoạ cho 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 cách chia sẻ 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 được cho phép.

Lỗi 401

Những lỗi này 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ể do thiếu uỷ quyền cho các phạm vi được yêu cầu. Mẫu JSON sau đây là minh hoạ cho 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 quá trình này không thành công, hãy hướng người dùng thông qua quy trình OAuth như mô tả trong phần Chọn phạm vi API Google Drive.

Lỗi 403

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

`activeItemCreationLimitExceeded`

Lỗi activeItemCreationLimitExceeded xảy ra khi vượt quá giới hạn số lượng mục được tạo cho mỗi tài khoản. Mỗi người dùng có thể tạo tối đa 500 triệu mục do một tài khoản tạo. Để biết thêm thông tin, hãy xem bài viết Giới hạn đối với mục 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 tài khoản tạo hơn 500 triệu mục.
Nếu người dùng phải tạo các mục trong chính 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 này.

`appNotAuthorizedToFile`

Lỗi này xảy ra khi ứng dụng của bạn không có trên 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 đây minh hoạ 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 cách sử dụ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 các quyền mà một mục được kế thừa trong bộ nhớ dùng chung. Bạn không thể xoá các quyền được kế thừa khỏi một mục trong bộ nhớ dùng chung. Mẫu JSON sau đây là minh hoạ cho 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 các quyền đối với mục gốc trực tiếp hoặc gián tiếp mà họ được kế thừa từ đó. Để biết thêm thông tin, hãy xem phần Truyền quyền. Bạn cũng có thể truy xuất tài nguyên permissions.permissionDetails để xem các quyền đối với mục trong bộ nhớ dùng chung này được kế thừa hay áp dụng trực tiếp.

`dailyLimitExceeded`

Lỗi này xảy ra khi bạn đã đạt đến giới hạn API cho dự án. Mẫu JSON sau đây là minh hoạ cho 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 để 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 cho hạn mức "Cụm từ tìm kiếm 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 minh hoạ 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 vào ứng dụng.

`fileOwnerNotMemberOfTeamDrive`

Lỗi này xảy ra khi bạn tìm cách 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à minh hoạ cho 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 có role=owner. Để biết thêm thông tin, hãy xem bài viết Chia sẻ tệp, thư mục và bộ nhớ.
Thêm tệp đó vào bộ nhớ dùng chung. Để biết thêm thông tin, hãy xem bài viết Tạo và điền thư mục.

`fileWriterTeamDriveMoveInDisabled`

Lỗi này xảy ra khi quản trị viên miền không cho phép những 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 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. Mẫu JSON sau đây là minh hoạ cho 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ả bộ nhớ 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 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à minh hoạ cho 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 vượt quá giới hạn về số lượng cấp độ thư mục lồng nhau. My Drive 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 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/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:

Thông báo cho người dùng rằng Drive ngăn việc đặt các thư mục sâu 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 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 vượt quá giới hạn về số phần tử con (thư mục, tệp và lối tắt) trong một thư mục. Một thư mục có 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 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 đối với thư mục Drive, hãy tham khảo Giới hạn thư mục trong Google Drive.

Mẫu JSON sau đây là minh hoạ cho 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 ngăn các thư mục chứa hơn 500.000 mục.
Nếu người dùng phải thêm nhiều mục hơn 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 giới hạn số lượng yêu cầu. 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à minh hoạ cho 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:

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 theo lô để thực hiện ít lệnh gọi API hơn.
Sử dụng tính năng 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 được liên kết với giới hạn email. Mẫu JSON sau đây là minh hoạ cho 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:

Đừng gửi email khi chia sẻ một lượng lớn tệp.
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 tài khoản Google Workspace, hãy cân nhắc sử dụng tài khoản dịch vụ có cơ chế 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à minh hoạ cho 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 lại hạn mức bộ nhớ tài khoản Drive của bạn. Để biết thêm thông tin, hãy tham khảo bài viết Giới hạn về bộ nhớ và giới hạn tải lên của Google Workspace.
Quản lý tệp trong bộ nhớ Google Drive.
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ề mục trên bộ nhớ 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 400.000 mục, bao gồm cả tệp, thư mục và lối tắt. Giới hạn 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 Giới hạn bộ nhớ dùng chung trong Google Drive.

Mẫu JSON sau đây là minh hoạ cho 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ể khó sắp xếp và tìm kiếm.

`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 là thành viên. Mẫu JSON sau đây là minh hoạ cho 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:

Hãy yêu cầu người quản lý bộ nhớ dùng chung cấp cho bạn các quyền thích hợp để thực hiện thao tác mà bạn phải thực hiện.
Xem lại Vai trò và quyền của Drive để tìm hiểu 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 trong bài viết 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 sang bộ nhớ dùng chung. Mẫu JSON sau đây là minh hoạ cho 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 vào bộ nhớ dùng chung bằng API Drive. Đặt tham số supportsAllDrives=true để biểu thị tính 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 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 phần Di chuyển thư mục vào bộ nhớ dùng chung 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 hơn một phần tử mẹ vào một mục trong bộ nhớ dùng chung. Mẫu JSON sau đây là minh hoạ cho 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 tệp. Mặc dù lối tắt chỉ có thể chứa một phần tử mẹ, nhưng bạn có thể sao chép một tệp lối tắt sang 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 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 ứng dụng của bạn. Mẫu JSON sau đây là minh hoạ cho 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 để lưu bản tổng quan nhanh trước khi tạo thêm.

`userRateLimitExceeded`

Lỗi này xảy ra khi đã đạt đến giới hạn cho mỗi người dùng. Đây có thể là giới hạn từ bảng điều khiển Google Cloud hoặc giới hạn từ phần phụ trợ của Drive. Mẫu JSON sau đây là minh hoạ cho 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:

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 thực hiện nhiều yêu cầu thay mặt cho nhiều người dùng của tài khoản Google Workspace, hãy cân nhắc sử dụng tài khoản dịch vụ có cơ chế uỷ quyền trên toàn miền bằng cách sử dụng tham số quotaUser.
Sử dụng tính năng thời gian đợi luỹ thừa để thử lại yêu cầu.

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

Lỗi 404

Những lỗi này nghĩa là tài nguyên được yêu cầu không truy cập được hoặc 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à minh hoạ cho 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 quyền truy cập vào tệp.

Lỗi 429

Những lỗi này đồng nghĩa với việc 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 khoảng thời gian nhất định. Mẫu JSON sau đây là minh hoạ cho 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 tính nă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 xảy ra lỗi không mong muốn với máy chủ trong quá trình xử lý yêu cầu. Có nhiều vấn đề có thể gây ra những lỗi này, bao gồm cả thời gian của một yêu cầu trùng lặp với một yêu cầu khác hoặc một yêu cầu một hành động không được hỗ trợ, chẳng hạn như tìm cách cập nhật quyền cho một trang duy nhất trong Google Sites thay vì toàn bộ trang web.

Dưới đây là danh sách 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 Hết thời gian chờ cổng vào

Để khắc phục lỗi này, hãy sử dụng tính nă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

invalidSharingRequest

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

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

Lỗi 401

authError

Lỗi 403

activeItemCreationLimitExceeded

appNotAuthorizedToFile

cannotModifyInheritedTeamDrivePermission

dailyLimitExceeded

domainPolicy

fileOwnerNotMemberOfTeamDrive

fileWriterTeamDriveMoveInDisabled

insufficientFilePermissions

myDriveHierarchyDepthLimitExceeded

numChildrenInNonRootLimitExceeded

rateLimitExceeded

sharingRateLimitExceeded

storageQuotaExceeded

teamDriveFileLimitExceeded

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`

`invalidSharingRequest`

`authError`

`activeItemCreationLimitExceeded`

`appNotAuthorizedToFile`

`cannotModifyInheritedTeamDrivePermission`

`dailyLimitExceeded`

`domainPolicy`

`fileOwnerNotMemberOfTeamDrive`

`fileWriterTeamDriveMoveInDisabled`

`insufficientFilePermissions`

`myDriveHierarchyDepthLimitExceeded`

`numChildrenInNonRootLimitExceeded`

`rateLimitExceeded`

`sharingRateLimitExceeded`

`storageQuotaExceeded`

`teamDriveFileLimitExceeded`

`teamDriveMembershipRequired`

`teamDrivesFolderMoveInNotSupported`

`teamDrivesParentLimit`

`UrlLeaseLimitExceeded`

`userRateLimitExceeded`

`notFound`

`rateLimitExceeded`