פרטי שגיאה ב-API של תיקיות

במאמר הזה מוסבר מה המשמעות של מחרוזות קודי השגיאה שמוחזרות כשפעולת Folder API נכשלת בגלל הפרה של הגבלת תיקייה. במקרה כזה, תוחזר שגיאת PreconditionFailure שמסבירה את ההפרה.

אם הכשל מתרחש באופן סינכרוני, הערך PreconditionFailure יוחזר באמצעות השדה Status.details. אם היא מתרחשת באופן אסינכרוני, הערך PreconditionFailure יוחזר בשדה Operation.error. הערכים האלה מופיעים כמחרוזות בשדה type של ההודעה PreconditionFailure.Violation שמוחזרת ב-Status.details.

מחרוזת סטטוס תיאור
ERROR_TYPE_UNSPECIFIED סוג השגיאה לא מזוהה או לא צוין.
ACTIVE_FOLDER_HEIGHT_VIOLATION הפעולה הזו תיצור עומק של יותר מארבע רמות בעץ התיקיות.
MAX_CHILD_FOLDERS_VIOLATION אי אפשר לבצע את הפעולה כי יווצרו יותר מ-300 תתי-תיקיות.
FOLDER_NAME_UNIQUENESS_VIOLATION הפעולה הזו תיצור כמה תיקיות עם אותו שם, בניגוד לדרישה שלכל תיקייה יהיה שם ייחודי.display_name
RESOURCE_DELETED_VIOLATION המשאב שרצית להעביר נמחק.
PARENT_DELETED_VIOLATION המשאב שהתיקייה נוספה אליו נמחק.
CYCLE_INTRODUCED_VIOLATION אי אפשר לבצע את הפעולה כי תיווצר מעגליות בנתיב של המשאב.
FOLDER_BEING_MOVED_VIOLATION הפעולה הזו תעביר תיקייה שכבר מועברת.
FOLDER_TO_DELETE_NON_EMPTY_VIOLATION התיקייה שהמתקשר מנסה למחוק מכילה משאבים פעילים או משויכת למדיניות חומת אש.
DELETED_FOLDER_HEIGHT_VIOLATION אי אפשר לבצע את הפעולה כי היא מפרה את מגבלת העומק המקסימלי של תיקיות שנמחקו. העומק של עץ התיקיות המלא (כולל תיקיות שנמחקו) לא יכול להיות יותר מ-8.