דף זה תורגם על ידי Cloud Translation API.

פתרון שגיאות

‫Google Drive API מחזיר שני סוגים של מידע על שגיאות:

קודי שגיאה של HTTP והודעות בכותרת.
אובייקט JSON בגוף התגובה עם פרטים נוספים שיכולים לעזור לכם לקבוע איך לטפל בשגיאה.

אפליקציות של Google Drive צריכות לזהות ולטפל בכל השגיאות שאפשר להיתקל בהן כשמשתמשים ב-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`

השגיאה הזו יכולה להתרחש בגלל אחת מהבעיות הבאות בקוד:

לא סופק שדה או פרמטר נדרש.
הערך שצוין או שילוב של שדות שצוינו לא תקינים.
ניסית להוסיף הורה כפול לקובץ ב-Drive.
ניסית להוסיף הורה שיצור מחזור בתרשים של הספרייה.

דוגמת ה-JSON הבאה מייצגת את השגיאה הזו:

{
  "error": {
    "code": 400,
    "errors": [
      {
        "domain": "global",
        "location": "orderBy",
        "locationType": "parameter",
        "message": "Sorting is not supported for queries with fullText terms. Results are always in descending relevance order.",
        "reason": "badRequest"
      }
    ],
    "message": "Sorting is not supported for queries with fullText terms. Results are always in descending relevance order."
  }
}

כדי לפתור את השגיאה הזו, צריך לבדוק את השדה message ולשנות את הקוד בהתאם.

`illegalKeepForeverModification`

השגיאה הזו מתרחשת כשמנסים להגדיר גרסה של קובץ Blob שסומנה כ-false. דוגמת ה-JSON הבאה מייצגת את השגיאה הזו:

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

כדי לתקן את השגיאה הזו, צריך למחוק לצמיתות את הגרסה של קובץ ה-Blob כדי להסיר את ההגדרה 'שמירה ללא הגבלת זמן'.

`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, כפי שמתואר במאמר בחירת היקפי הרשאות של Google Drive API.

`fileNotDownloadable`

השגיאה הזו מתרחשת כשמנסים להשתמש בשיטה revisions.get עם פרמטר כתובת ה-URL alt=media במסמך Google Workspace. הנה דוגמה ל-JSON שמייצג את השגיאה הזו:

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

כדי לפתור את השגיאה, אפשר לנסות את הפתרונות הבאים:

אם רוצים לראות את המטא-נתונים של גרסה מסוימת, כמו סוג ה-MIME, צריך להסיר את הפרמטר של כתובת ה-URL‏ alt=media.
משתמשים בשיטה files.export כדי לייצא תוכן של בייט של מסמך Google Workspace. מידע נוסף זמין במאמר ייצוא תוכן של מסמך Google Workspace.

שגיאות 403

השגיאות האלה מציינות שחריגה ממגבלת השימוש או שלמשתמש אין את ההרשאות הנכונות. כדי לזהות את הגורם לבעיה, צריך לבדוק את השדה reason בקובץ ה-JSON שמוחזר.

מידע על מגבלות של Drive API מופיע במאמר מגבלות שימוש. מידע על מגבלות של תיקיות ב-Drive זמין במאמר מגבלות על קבצים ותיקיות.

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

כדי לפתור את השגיאה:

מודיעים למשתמש שמערכת Drive מונעת מחשבונות ליצור יותר מ-500 מיליון פריטים.
אם המשתמש צריך ליצור פריטים באותו חשבון, צריך להנחות אותו למחוק חלק מהאובייקטים באופן סופי. אחרת, הם יכולים להשתמש בחשבון אחר שכבר עומד בדרישה.

`appNotAuthorizedToFile`

השגיאה הזו מתרחשת כשהאפליקציה לא נמצאת ברשימת בקרת הגישה (ACL) של הקובץ. השגיאה הזו מונעת מהמשתמש לפתוח את הקובץ באמצעות האפליקציה שלכם. דוגמת ה-JSON הבאה מייצגת את השגיאה הזו:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "appNotAuthorizedToFile",
        "message": "The user has not granted the app {appId} {verb} access to the file {fileId}."
      }
    ],
    "code": 403,
    "message": "The user has not granted the app {appId} {verb} access to the file {fileId}."
  }
}

כדי לפתור את השגיאה, אפשר לנסות את הפתרונות הבאים:

פותחים את בורר הקבצים של Google Drive ומבקשים מהמשתמש לפתוח את הקובץ.
מנחים את המשתמש לפתוח את הקובץ באמצעות תפריט ההקשר פתיחה באמצעות בממשק המשתמש של Drive באפליקציה.
משתמשים בשיטה 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 כדי לראות אם ההרשאות לגבי הפריט הזה באחסון השיתופי הועברו בירושה או הוחלו ישירות.

`dailyLimitExceeded`

השגיאה הזו מתרחשת כשהגעתם למגבלת ה-API של הפרויקט. דוגמת ה-JSON הבאה מייצגת את השגיאה הזו:

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

השגיאה הזו מופיעה כשבעלי האפליקציה הגדירו מכסת שימוש במשאב מסוים. כדי לתקן את השגיאה, מסירים את כל מגבלות השימוש במכסת 'שאילתות ליום'.

`domainPolicy`

השגיאה הזו מתרחשת כשמדיניות הדומיין של המשתמש לא מאפשרת לאפליקציה שלכם גישה ל-Drive. דוגמה ל-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."
  }
}

כדי לפתור את השגיאה:

מודיעים למשתמש שהדומיין לא מאפשר לאפליקציה שלך לגשת לקבצים ב-Drive.
מנחים את המשתמש לפנות לאדמין בדומיין כדי לבקש גישה לאפליקציה.

`downloadRestrictedForRevision`

השגיאה הזו מתרחשת כשהמשתמש לא יכול להוריד גרסה של קובץ blob. הנה דוגמה ל-JSON שמייצגת את השגיאה הזו:

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

כדי לתקן את השגיאה הזו, צריך להודיע למשתמש שהדרך היחידה להוריד גרסאות של קובץ blob היא אם הן מסומנות כ'שמירה לתמיד'. מידע נוסף זמין במאמר בנושא ציון גרסאות שרוצים לשמור כדי שלא יימחקו אוטומטית.

`fileOwnerNotMemberOfTeamDrive`

השגיאה הזו מתרחשת כשמנסים להעביר קובץ לאחסון שיתופי והבעלים של הקובץ לא חבר באחסון השיתופי. דוגמת ה-JSON הבאה מייצגת את השגיאה הזו:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "fileOwnerNotMemberOfTeamDrive",
        "message": "Cannot move a file into a shared drive as a writer when the owner of the file is not a member of that shared drive."
      }
    ],
    "code": 403,
    "message": "Cannot move a file into a shared drive as a writer when the owner of the file is not a member of that shared drive."
  }
}

כדי לפתור את השגיאה:

מוסיפים את החבר לאחסון השיתופי באמצעות role=owner. מידע נוסף זמין במאמר שיתוף קבצים, תיקיות ותיקיות אחסון שיתופי.
מוסיפים את הקובץ לאחסון השיתופי. מידע נוסף זמין במאמר יצירה של תיקיות והוספת קבצים לתיקיות.

`fileWriterTeamDriveMoveInDisabled`

השגיאה הזו מתרחשת כשמנהל דומיין לא מאפשר למשתמשים עם role=writer להעביר פריטים לאחסון השיתופי. למשתמש שמנסה להעביר את הפריטים יש פחות הרשאות מההרשאות שמותרות באחסון השיתופי של היעד. הנה דוגמה ל-JSON שמייצגת את השגיאה הזו:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "fileWriterTeamDriveMoveInDisabled",
        "message": "The domain administrator has not allowed writers to move items into a shared drive."
      }
    ],
    "code": 403,
    "message": "The domain administrator has not allowed writers to move items into a shared drive."
  }
}

כדי לפתור את השגיאה הזו, צריך להשתמש באותו חשבון משתמש אדמין גם בתיקיית האחסון השיתופי של המקור וגם בתיקיית האחסון השיתופי של היעד.

`insufficientFilePermissions`

השגיאה הזו מתרחשת כשאין למשתמש הרשאת כתיבה לקובץ, והאפליקציה מנסה לשנות את הקובץ. דוגמת ה-JSON הבאה מייצגת את השגיאה הזו:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "insufficientFilePermissions",
        "message": "The user does not have sufficient permissions for file {fileId}."
      }
    ],
    "code": 403,
    "message": "The user does not have sufficient permissions for file {fileId}."
  }
}

כדי לפתור את השגיאה הזו, צריך להנחות את המשתמש לפנות לבעלים של הקובץ ולבקש גישת עריכה. אפשר גם לבדוק את רמות הגישה של המשתמשים במטא-נתונים שאוחזרו באמצעות השיטה files.get ולהציג ממשק משתמש לקריאה בלבד כשחסרות הרשאות.

`myDriveHierarchyDepthLimitExceeded`

שגיאה myDriveHierarchyDepthLimitExceeded מתרחשת כשחורגים מהמגבלה של מספר רמות התיקיות המקוננות. בתיקייה'האחסון שלי' של משתמש יכולות להיות עד 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/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."
 }
}

כדי לפתור את השגיאה:

מודיעים למשתמש ש-Drive מונע הצבת תיקיות בעומק של יותר מ-100 רמות.
אם המשתמש צריך ליצור עוד תיקייה מקוננת, צריך להנחות אותו לארגן מחדש את תיקיית האב המיועדת כך שהיא תהיה בעומק של פחות מ-100 רמות, או להשתמש בתיקיית אב אחרת שכבר עומדת בדרישה.

`numChildrenInNonRootLimitExceeded`

השגיאה הזו מתרחשת כשחורגים מהמגבלה של מספר הפריטים (תיקיות, קבצים וקיצורי דרך) בתיקייה. יש מגבלה של 500,000 פריטים על תיקיות, קבצים וקיצורי דרך ישירות בתיקייה. פריטים שמוטמעים בתיקיות משנה לא נספרים במגבלת 500,000 הפריטים. מידע נוסף על מגבלות בתיקיות ב-Drive זמין במאמר מגבלות על תיקיות ב-Google Drive.

דוגמת ה-JSON הבאה מייצגת את השגיאה הזו:

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "numChildrenInNonRootLimitExceeded",
    "message": "The limit for this folder's number of children (files and folders) has been exceeded."
   }
  ],
  "code": 403,
  "message": "The limit for this folder's number of children (files and folders) has been exceeded."
 }
}

כדי לפתור את השגיאה, אפשר לנסות את הפתרונות הבאים:

הודעה למשתמש ש-Drive מונע יצירת תיקיות עם יותר מ-500,000 פריטים.
אם המשתמש צריך להוסיף עוד פריטים לתיקייה המלאה, צריך להנחות אותו לארגן מחדש את התיקייה כך שתכיל פחות מ-500,000 פריטים, או להשתמש בתיקייה דומה שכבר מכילה פחות פריטים.

`rateLimitExceeded`

השגיאה הזו מתרחשת כשמגיעים למגבלת הקצב של הפרויקט. המגבלה הזו משתנה בהתאם לסוג הבקשה. דוגמת ה-JSON הבאה מייצגת את השגיאה הזו:

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

כדי לפתור את השגיאה, אפשר לנסות את הפתרונות הבאים:

הגדלת המכסה לכל משתמש בפרויקט Google Cloud. למידע נוסף, אפשר לבקש להגדיל את המכסות.
בקשות באצווה כדי לאגד כמה קריאות ל-API לבקשת HTTP אחת.
כדאי להשתמש בהשהיה מעריכית לפני ניסיון חוזר (exponential backoff) כדי לנסות לשלוח שוב את הבקשה.

`sharingRateLimitExceeded`

השגיאה הזו מתרחשת כשהמשתמש מגיע למגבלת השיתוף, ולרוב היא קשורה למגבלת אימייל. דוגמת ה-JSON הבאה מייצגת את השגיאה הזו:

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "message": "Rate limit exceeded. User message: \"These item(s) could not be shared because a rate limit was exceeded: filename",
    "reason": "sharingRateLimitExceeded",
   }
  ],
  "code": 403,
  "message": "Rate Limit Exceeded"
 }
}

כדי לפתור את השגיאה:

לא מומלץ לשלוח אימיילים כשמשתפים כמויות גדולות של קבצים.
אם משתמש אחד שולח בקשות רבות בשם משתמשים רבים בחשבון Google Workspace, כדאי לשקול שימוש בחשבון שירות עם הענקת הרשאות גישה ברמת הדומיין באמצעות הפרמטר quotaUser.

`storageQuotaExceeded`

השגיאה הזו מתרחשת כשהמשתמש מגיע למגבלת האחסון שלו. הנה דוגמה ל-JSON שמייצג את השגיאה הזו:

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "message": "The user's Drive storage quota has been exceeded.",
    "reason": "storageQuotaExceeded",
   }
  ],
  "code": 403,
  "message": "The user's Drive storage quota has been exceeded."
 }
}

כדי לפתור את השגיאה:

בודקים את מגבלות האחסון בחשבון Drive. מידע נוסף זמין במאמר מגבלות של אחסון והעלאה ב-Google Workspace.
איך מנהלים את האחסון ב-Drive, ב-Gmail וב-Google Photos
איך קונים נפח אחסון נוסף בחשבון Google

`teamDriveFileLimitExceeded`

השגיאה הזו מתרחשת כשמשתמש מנסה לחרוג ממגבלת הפריטים הקפדנית באחסון שיתופי. בכל תיקייה באחסון השיתופי של המשתמש אפשר לאחסן עד 500,000 פריטים, כולל קבצים, תיקיות וקיצורי דרך. המגבלה הזאת נקבעת על סמך מספר הפריטים ולא לפי נפח האחסון שבשימוש. מידע נוסף זמין במאמר מגבלות על אחסון שיתופי ב-Google Drive.

דוגמת ה-JSON הבאה מייצגת את השגיאה הזו:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "teamDriveFileLimitExceeded",
        "message": "The file limit for this shared drive has been exceeded."
      }
    ],
    "code": 403,
    "message": "The file limit for this shared drive has been exceeded."
  }
}

כדי לפתור את השגיאה, צריך להקטין את מספר הפריטים באחסון השיתופי. יכולים להיות קשיים בארגון ובחיפוש בתיקיות אחסון שיתופי שיש בהן יותר מדי קבצים.

`teamDriveHierarchyTooDeep`

שגיאה teamDriveHierarchyTooDeep מתרחשת כשחורגים מהמגבלה של מספר רמות התיקיות המקוננות באחסון השיתופי. בתיקיית אחסון שיתופי של משתמש יכולות להיות עד 100 רמות של תיקיות מקוננות. מידע נוסף זמין במאמר בנושא מגבלת העומק בתיקייה.

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "teamDriveHierarchyTooDeep",
    "message": "The shared drive hierarchy depth will exceed the limit."
   }
  ],
  "code": 403,
  "message": "The shared drive hierarchy depth will exceed the limit."
 }
}

כדי לפתור את השגיאה:

צריך להודיע למשתמש שתיקיות אחסון שיתופי לא מאפשרות להציב תיקיות בעומק של יותר מ-100 רמות.
אם המשתמש צריך ליצור עוד תיקייה מקוננת, צריך להנחות אותו לארגן מחדש את תיקיית האב המיועדת כך שהיא תהיה בעומק של פחות מ-100 רמות, או להשתמש בתיקיית אב אחרת שכבר עומדת בדרישה.

`teamDriveMembershipRequired`

השגיאה הזו מתרחשת כשמשתמש מנסה לגשת לאחסון שיתופי שהוא לא חבר בו. דוגמת ה-JSON הבאה מייצגת את השגיאה הזו:

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

כדי לפתור את השגיאה, אפשר לנסות את הפתרונות הבאים:

צריך לבקש ממנהל האחסון השיתופי להוסיף אתכם עם ההרשאות המתאימות לפעולה שאתם צריכים לבצע.
כדי לדעת למי יש גישה לאחסון השיתופי ומי יכול לנהל אותו, כדאי לעיין בתפקידים ובהרשאות ב-Drive. מידע נוסף על רמות גישה זמין גם במאמר יצירת תיקיית אחסון שיתופי.

`teamDrivesFolderMoveInNotSupported`

השגיאה הזו מתרחשת כשמשתמש מנסה להעביר תיקייה מ'האחסון שלי' לאחסון שיתופי. דוגמת ה-JSON הבאה מייצגת את השגיאה הזו:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "teamDrivesFolderMoveInNotSupported",
        "message": "Moving folders into shared drives is not supported."
      }
    ],
    "code": 403,
    "message": "Moving folders into shared drives is not supported."
  }
}

כדי לפתור את השגיאה, אפשר לנסות את הפתרונות הבאים:

מעבירים את הפריטים הבודדים מהתיקייה לאחסון שיתופי באמצעות Drive API. מגדירים את הפרמטר supportsAllDrives=true כדי לציין תמיכה ב'אחסון שלי' ובתיקיות אחסון שיתופי.
אם אתם חייבים להעביר את התיקייה לאחסון שיתופי, אתם יכולים להשתמש בממשק המשתמש של Drive. מידע נוסף זמין במאמר העברת תיקיות לתיקיות אחסון שיתופי כאדמין.

`teamDrivesParentLimit`

השגיאה הזו מתרחשת כשמשתמש מנסה להוסיף יותר מהורה אחד לפריט באחסון שיתופי. דוגמת ה-JSON הבאה מייצגת את השגיאה הזו:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "teamDrivesParentLimit",
        "message": "A shared drive item must have exactly one parent."
      }
    ],
    "code": 403,
    "message": "A shared drive item must have exactly one parent."
  }
}

כדי לתקן את השגיאה הזו, צריך להשתמש בקיצורי דרך ב-Drive כדי להוסיף כמה קישורים לקובץ. למרות שלקיצור דרך יכולה להיות רק תיקיית אם אחת, אפשר להעתיק קובץ של קיצור דרך למיקומים נוספים. למידע נוסף, ראו יצירת קיצור דרך לקובץ ב-Drive.

`UrlLeaseLimitExceeded`

השגיאה הזו מתרחשת כשמנסים לשמור נתוני משחקים ב-Google Play דרך האפליקציה. דוגמת ה-JSON הבאה מייצגת את השגיאה הזו:

{
 "error": {
  "errors": [
   {
    "domain": "usageLimits",
    "reason": "UrlLeaseLimitExceeded",
    "message": "Too many pending uploads for this snapshot. Please finish or cancel some before creating more."
   }
  ],
  "code": 403,
  "message": "Too many pending uploads for this snapshot. Please finish or cancel some before creating more."
 }
}

כדי לפתור את השגיאה הזו, צריך להשלים או לבטל את כל ההעלאות של תמונת מצב לפני שיוצרים עוד תמונות מצב.

`userRateLimitExceeded`

השגיאה הזו מתרחשת כשמגיעים למגבלה לכל משתמש. יכול להיות שזו מגבלה ממסוף Google Cloud או מגבלה מהקצה העורפי של Drive. דוגמת ה-JSON הבאה מייצגת את השגיאה הזו:

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

כדי לפתור את השגיאה, אפשר לנסות את הפתרונות הבאים:

הגדלת המכסה לכל משתמש בפרויקט Google Cloud. למידע נוסף, אפשר לבקש להגדיל את המכסות.
אם משתמש אחד שולח בקשות רבות בשם משתמשים רבים בחשבון Google Workspace, כדאי לשקול שימוש בחשבון שירות עם הענקת הרשאות גישה ברמת הדומיין באמצעות הפרמטר quotaUser.
כדאי להשתמש בהשהיה מעריכית לפני ניסיון חוזר (exponential backoff) כדי לנסות לשלוח שוב את הבקשה.

מידע על מגבלות של Drive API מופיע במאמר מגבלות שימוש.

שגיאות 404

השגיאות האלה מציינות שאי אפשר לגשת למשאב המבוקש או שהוא לא קיים.

`notFound`

השגיאה הזו מתרחשת כשאין למשתמש גישת קריאה לקובץ, או שהקובץ לא קיים. דוגמת ה-JSON הבאה מייצגת את השגיאה הזו:

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

כדי לפתור את השגיאה:

אם הקובץ נמצא באחסון שיתופי ואתם משתמשים בשיטה files.get, ודאו שפרמטר השאילתה supportsAllDrives מוגדר לערך true.
הודעה למשתמש שאין לו גישת קריאה לקובץ או שהקובץ לא קיים.
מנחים את המשתמש לפנות לבעלים של הקובץ ולבקש הרשאה לקובץ.

שגיאות 429

השגיאות האלה מציינות שיותר מדי בקשות נשלחו ל-API מהר מדי.

`rateLimitExceeded`

השגיאה הזו מתרחשת כשהמשתמש שולח יותר מדי בקשות בפרק זמן מסוים. דוגמת ה-JSON הבאה מייצגת את השגיאה הזו:

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

כדי לפתור את השגיאה הזו, צריך להשתמש בהשהיה מעריכית לפני ניסיון חוזר כדי לנסות שוב את הבקשה.

שגיאות 500,‏ 502,‏ 503 ו-504

השגיאות האלה מתרחשות כשיש שגיאת שרת לא צפויה במהלך עיבוד הבקשה. יש מגוון בעיות שיכולות לגרום לשגיאות האלה, כולל תזמון של בקשה שחופף לבקשה אחרת או בקשה לפעולה לא נתמכת, כמו ניסיון לעדכן הרשאות לדף יחיד ב-Google Sites במקום לכל האתר.

רשימה של שגיאות 5xx:

‫500 שגיאת קצה עורפי
‫‎502 Bad Gateway
‫‎503 Service Unavailable
‫‎504 Gateway Timeout

כדי לפתור את השגיאה הזו, צריך להשתמש בהשהיה מעריכית לפני ניסיון חוזר כדי לנסות שוב את הבקשה.

פתרון שגיאות קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

סיכום קודי מצב HTTP

שגיאות 400

badRequest

illegalKeepForeverModification

invalidSharingRequest

השיתוף בוצע בהצלחה, אבל האימייל עם ההתראה לא נמסר כמו שצריך

למשתמש הזה אין הרשאה לשנות את רשימת ה-ACL

שגיאות 401

authError

fileNotDownloadable

שגיאות 403

activeItemCreationLimitExceeded

appNotAuthorizedToFile

cannotModifyInheritedTeamDrivePermission

dailyLimitExceeded

domainPolicy

downloadRestrictedForRevision

fileOwnerNotMemberOfTeamDrive

fileWriterTeamDriveMoveInDisabled

insufficientFilePermissions

myDriveHierarchyDepthLimitExceeded

numChildrenInNonRootLimitExceeded

rateLimitExceeded

sharingRateLimitExceeded

storageQuotaExceeded

teamDriveFileLimitExceeded

teamDriveHierarchyTooDeep

teamDriveMembershipRequired

teamDrivesFolderMoveInNotSupported

teamDrivesParentLimit

UrlLeaseLimitExceeded

userRateLimitExceeded

שגיאות 404

notFound

שגיאות 429

rateLimitExceeded

שגיאות 500,‏ 502,‏ 503 ו-504

נושאים קשורים

פתרון שגיאות

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