資料夾 API 錯誤詳細資料

本主題說明資料夾 API 作業因違反資料夾限制而失敗時傳回的錯誤代碼字串意義。發生這種情況時，會傳回 PreconditionFailure 以說明違規詳情。

如果同步發生失敗，則使用 Status.details 欄位傳回 PreconditionFailure。如果非同步發生失敗，則使用 Operation.error 欄位傳回 PreconditionFailure。這些值會以字串顯示於 PreconditionFailure.Violation 訊息的類型欄位，並在 Status.details 中傳回。

狀態字串 說明
ERROR_TYPE_UNSPECIFIED 無法辨別或未指定錯誤類型。
ACTIVE_FOLDER_HEIGHT_VIOLATION 這個動作會導致資料夾的樹狀結構深度超出上限 4。
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 層 (包含已刪除的資料夾)。