แก้ไขข้อผิดพลาด

Google Drive API จะแสดงข้อมูลข้อผิดพลาด 2 ระดับดังนี้

  • รหัสข้อผิดพลาดของ HTTP และข้อความส่วนหัว
  • ออบเจ็กต์ JSON ในเนื้อหาการตอบกลับพร้อมรายละเอียดเพิ่มเติมที่สามารถช่วยคุณได้ กำหนดวิธีจัดการข้อผิดพลาด

แอป Google ไดรฟ์ควรดักจับและจัดการกับข้อผิดพลาดทั้งหมดที่อาจพบ เมื่อใช้ REST API คู่มือนี้จะกล่าวถึงวิธีแก้ไข ข้อผิดพลาดเฉพาะของ Drive 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 และปรับเปลี่ยนโค้ดให้สอดคล้องกัน

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 ไดรฟ์

ข้อผิดพลาด 403

ข้อผิดพลาดเหล่านี้หมายความว่าการใช้งานเกินขีดจำกัดแล้ว หรือผู้ใช้ไม่ได้ สิทธิ์ที่ถูกต้อง หากต้องการหาสาเหตุ ให้ประเมินฟิลด์ reason ของ JSON ที่แสดงผล

โปรดดูข้อมูลเกี่ยวกับขีดจำกัดของ Drive 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."
 }
}

วิธีแก้ไขข้อผิดพลาดนี้

  1. แจ้งให้ผู้ใช้ทราบว่าไดรฟ์ป้องกันไม่ให้สร้างบัญชี มากกว่า 500 ล้านรายการ

  2. หากผู้ใช้ต้องสร้างรายการในบัญชีเดียวกันนี้ โปรดแนะนำให้ผู้ใช้ ลบออบเจ็กต์บางรายการออกอย่างถาวร ไม่เช่นนั้น ผู้ใช้จะใช้บัญชีอื่นได้ ที่เป็นไปตามข้อกำหนด

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 ไดรฟ์ และแจ้งให้ผู้ใช้เปิดไฟล์
  • แจ้งให้ผู้ใช้เปิดไฟล์โดยใช้เมนูตามบริบทเปิดด้วยในไดรฟ์ 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."
  }
}

วิธีแก้ไขข้อผิดพลาดนี้

  1. แจ้งให้ผู้ใช้ทราบว่าโดเมนไม่อนุญาตให้แอปของคุณเข้าถึงไฟล์ต่างๆ ไดรฟ์
  2. แจ้งให้ผู้ใช้ติดต่อผู้ดูแลระบบโดเมนเพื่อขอสิทธิ์เข้าถึง แอปของคุณ

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

วิธีแก้ไขข้อผิดพลาดนี้

  1. เพิ่มสมาชิกในไดรฟ์ที่แชร์กับ role=owner สำหรับข้อมูลเพิ่มเติม โปรดดูหัวข้อแชร์ไฟล์ โฟลเดอร์ และไดรฟ์

  2. เพิ่มไฟล์ในไดรฟ์ที่แชร์ สำหรับข้อมูลเพิ่มเติม โปรดดูที่สร้างและ ป้อนข้อมูลโฟลเดอร์

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 เกิดขึ้นเมื่อขีดจำกัดสำหรับ มีจำนวนระดับของโฟลเดอร์ที่ซ้อนกันเกินกำหนดแล้ว แท็ก "My" ของผู้ใช้ ไดรฟ์มีโฟลเดอร์ที่ซ้อนกันได้ไม่เกิน 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."
 }
}

วิธีแก้ไขข้อผิดพลาดนี้

  1. แจ้งให้ผู้ใช้ทราบว่าไดรฟ์ป้องกันไม่ให้วางโฟลเดอร์เกิน ลึก 100 ระดับ
  2. หากผู้ใช้ต้องสร้างโฟลเดอร์ที่ซ้อนอยู่อีกโฟลเดอร์หนึ่ง โปรดแจ้งให้ผู้ใช้จัดระเบียบใหม่ โฟลเดอร์หลักควรมีความลึกน้อยกว่า 100 ระดับ หรือใช้ โฟลเดอร์หลักอื่นที่มีคุณสมบัติตรงตามข้อกำหนดอยู่แล้ว

numChildrenInNonRootLimitExceeded

ข้อผิดพลาดนี้เกิดขึ้นเมื่อจำนวนโฟลเดอร์ย่อย (โฟลเดอร์, ไฟล์ และทางลัด) เกินขีดจำกัดแล้ว มีการจำกัด 500,000 รายการสำหรับ โฟลเดอร์ ไฟล์ และทางลัดไว้ในโฟลเดอร์ได้โดยตรง รายการที่ซ้อนในโฟลเดอร์ย่อย จะไม่ถูกนับรวมในขีดจำกัด 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"
 }
}

โปรดลองวิธีต่อไปนี้เพื่อแก้ไข

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

วิธีแก้ไขข้อผิดพลาดนี้

  1. อย่าส่งอีเมลเมื่อแชร์ไฟล์จำนวนมาก
  2. หากผู้ใช้รายหนึ่งส่งคำขอจำนวนมากในนามของผู้ใช้หลายรายของ บัญชี 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."
 }
}

วิธีแก้ไขข้อผิดพลาดนี้

  1. ตรวจสอบขีดจำกัดพื้นที่เก็บข้อมูลของบัญชีไดรฟ์ สำหรับข้อมูลเพิ่มเติม โปรดดูข้อมูลที่หัวข้อพื้นที่เก็บข้อมูลและการอัปโหลดของ Google Workspace ขีดจำกัด

  2. จัดการไฟล์ใน Google ไดรฟ์ พื้นที่เก็บข้อมูล

  3. ซื้อ 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."
 }
}

วิธีแก้ไขข้อผิดพลาดนี้

  1. แจ้งให้ผู้ใช้ทราบว่าไดรฟ์ที่แชร์ป้องกันไม่ให้วางโฟลเดอร์เกิน ลึก 100 ระดับ
  2. หากผู้ใช้ต้องสร้างโฟลเดอร์ที่ซ้อนอยู่อีกโฟลเดอร์หนึ่ง โปรดแจ้งให้ผู้ใช้จัดระเบียบใหม่ โฟลเดอร์หลักควรมีความลึกน้อยกว่า 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."
  }
}

โปรดลองวิธีต่อไปนี้เพื่อแก้ไข

  1. ขอให้ผู้จัดการของไดรฟ์ที่แชร์เพิ่มคุณ สิทธิ์สำหรับการดำเนินการที่คุณต้องกระทำ

  2. ตรวจสอบบทบาทและ สิทธิ์เพื่อดูว่าใครเข้าถึงและจัดการได้บ้าง ไดรฟ์ที่แชร์ นอกจากนี้ยังดูข้อมูลเพิ่มเติมเกี่ยวกับระดับการเข้าถึงได้ ที่ สร้าง ไดรฟ์

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 เพื่อแสดงพารามิเตอร์ รองรับทั้งไดรฟ์ของฉันและไดรฟ์ที่แชร์

  • หากต้องย้ายโฟลเดอร์ไปยังไดรฟ์ที่แชร์ ให้ใช้ UI ไดรฟ์ โปรดดูข้อมูลเพิ่มเติมที่ย้ายโฟลเดอร์ไปยังการแชร์ ในฐานะผู้ดูแลระบบ

teamDrivesParentLimit

ข้อผิดพลาดนี้เกิดขึ้นเมื่อผู้ใช้พยายามเพิ่มหน่วยโฆษณาหลักมากกว่า 1 บัญชีไปยังรายการใน ไดรฟ์ที่แชร์ ตัวอย่าง 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."
  }
}

หากต้องการแก้ไขข้อผิดพลาดนี้ ให้ใช้แป้นพิมพ์ลัดของไดรฟ์เพื่อเพิ่มหลายลิงก์ไปยัง แม้ว่าทางลัดหนึ่งจะมีระดับบนสุดได้เพียง 1 รายการ แต่ก็มีไฟล์ทางลัดได้ คัดลอกไปยังตำแหน่งเพิ่มเติมแล้ว สำหรับข้อมูลเพิ่มเติม โปรดดูที่สร้าง ทางลัดไปยังไฟล์ในไดรฟ์

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 Console หรือขีดจำกัดจากไดรฟ์ แบ็กเอนด์ ตัวอย่าง JSON ต่อไปนี้แสดงถึงข้อผิดพลาดนี้

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

โปรดลองวิธีต่อไปนี้เพื่อแก้ไข

  • เพิ่มโควต้าต่อผู้ใช้ในโปรเจ็กต์ Google Cloud สำหรับข้อมูลเพิ่มเติม ขอเพิ่มโควต้า

โปรดดูข้อมูลเกี่ยวกับขีดจำกัดของ Drive API ได้ที่ขีดจำกัดการใช้งาน

ข้อผิดพลาด 404

ข้อผิดพลาดเหล่านี้หมายความว่าทรัพยากรที่ขอเข้าถึงไม่ได้หรือไม่มีอยู่

notFound

ข้อผิดพลาดนี้เกิดขึ้นเมื่อผู้ใช้ไม่มีสิทธิ์อ่านไฟล์หรือไฟล์ ไม่มีอยู่ ตัวอย่าง JSON ต่อไปนี้แสดงถึงข้อผิดพลาดนี้

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

วิธีแก้ไขข้อผิดพลาดนี้

  1. หากไฟล์อยู่ในไดรฟ์ที่แชร์และคุณกำลังใช้ files.get โปรดตรวจสอบว่า ตั้งค่าพารามิเตอร์การค้นหาของ supportsAllDrives เป็น true แล้ว
  2. แจ้งให้ผู้ใช้ทราบว่าตนไม่มีสิทธิ์อ่านไฟล์หรือไฟล์ ไม่มีอยู่
  3. แจ้งให้ผู้ใช้ติดต่อเจ้าของไฟล์และขอสิทธิ์

ข้อผิดพลาด 429

ข้อผิดพลาดเหล่านี้หมายความว่ามีการส่งคำขอไปยัง API มากเกินไปเร็วเกินไป

rateLimitExceeded

ข้อผิดพลาดนี้เกิดขึ้นเมื่อผู้ใช้ส่งคำขอมากเกินไปใน ระยะเวลา ตัวอย่าง JSON ต่อไปนี้แสดงถึงข้อผิดพลาดนี้

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

หากต้องการแก้ไขข้อผิดพลาดนี้ ให้ใช้ Exponential Backoff เพื่อลองส่งคำขออีกครั้ง

ข้อผิดพลาด 500, 502, 503, 504

ข้อผิดพลาดเหล่านี้เกิดขึ้นเมื่อเกิดข้อผิดพลาดที่ไม่คาดคิดของเซิร์ฟเวอร์ขณะประมวลผล อีกครั้ง ปัญหาต่างๆ อาจทำให้เกิดข้อผิดพลาดเหล่านี้ รวมถึงช่วงเวลาของคำขอ ทับซ้อนกับคำขออื่นหรือคำขอให้ดำเนินการที่ไม่รองรับ เช่น การพยายามอัปเดตสิทธิ์สำหรับหน้าเว็บเดียวใน Google Sites แทน ทั่วทั้งเว็บไซต์

รายการข้อผิดพลาด 5xx มีดังนี้

  • 500 ข้อผิดพลาดของแบ็กเอนด์
  • 502 เกตเวย์ไม่ถูกต้อง
  • 503 ไม่พร้อมให้บริการ
  • 504 เกตเวย์หมดเวลา

หากต้องการแก้ไขข้อผิดพลาดนี้ ให้ใช้ Exponential Backoff เพื่อลองส่งคำขออีกครั้ง