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

פתרון שגיאות

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

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

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

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

השגיאה הזו מתקבלת כשמנסים להשתמש ב-method 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 type, צריך להסיר את הפרמטר של כתובת ה-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`

השגיאה הזו מתרחשת כשהאפליקציה לא נכללת ברשימת הרשאות הגישה לקובץ. השגיאה הזו מונעת מהמשתמש לפתוח את הקובץ באמצעות האפליקציה. דוגמת ה-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 באפליקציה.
משתמשים ב-method‏ 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`

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

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

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

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

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

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

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

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

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

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

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

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

פתרון שגיאות

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

שגיאות 400

badRequest

invalidSharingRequest

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

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

שגיאות 401

authError

fileNotDownloadable

שגיאות 403

activeItemCreationLimitExceeded

appNotAuthorizedToFile

cannotModifyInheritedTeamDrivePermission

dailyLimitExceeded

domainPolicy

fileOwnerNotMemberOfTeamDrive

fileWriterTeamDriveMoveInDisabled

insufficientFilePermissions

myDriveHierarchyDepthLimitExceeded

numChildrenInNonRootLimitExceeded

rateLimitExceeded

sharingRateLimitExceeded

storageQuotaExceeded

teamDriveFileLimitExceeded

teamDriveHierarchyTooDeep

teamDriveMembershipRequired

teamDrivesFolderMoveInNotSupported

teamDrivesParentLimit

UrlLeaseLimitExceeded

userRateLimitExceeded

שגיאות 404

notFound

שגיאות 429

rateLimitExceeded

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

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

`badRequest`

`invalidSharingRequest`

`authError`

`fileNotDownloadable`

`activeItemCreationLimitExceeded`

`appNotAuthorizedToFile`

`cannotModifyInheritedTeamDrivePermission`

`dailyLimitExceeded`

`domainPolicy`

`fileOwnerNotMemberOfTeamDrive`

`fileWriterTeamDriveMoveInDisabled`

`insufficientFilePermissions`

`myDriveHierarchyDepthLimitExceeded`

`numChildrenInNonRootLimitExceeded`

`rateLimitExceeded`

`sharingRateLimitExceeded`

`storageQuotaExceeded`

`teamDriveFileLimitExceeded`

`teamDriveHierarchyTooDeep`

`teamDriveMembershipRequired`

`teamDrivesFolderMoveInNotSupported`

`teamDrivesParentLimit`

`UrlLeaseLimitExceeded`

`userRateLimitExceeded`

`notFound`

`rateLimitExceeded`