如何通过Autodesk Construction Cloud (ACC) API修改文件描述？

官方API支持 #

Autodesk Construction Cloud (ACC) 的Document Management API提供了直接更新文件描述和名称的端点，你可以通过PATCH请求修改文件元数据：

• 端点：PATCH /data/v1/projects/{project_id}/items/{item_id}
• 核心可修改字段：
  • attributes.name：用于修改文件名称
  • attributes.description：用于更新文件描述

请求体示例（JSON格式）：

{
  "data": {
    "type": "items",
    "id": "{item_id}",
    "attributes": {
      "name": "新文件名.pdf",
      "description": "这是更新后的文件描述内容"
    }
  }
}

注意：请求需携带有效的ACC OAuth2令牌，且令牌需具备data:write权限。

替代方案（若官方端点受限） #

如果因权限或区域限制无法直接使用PATCH端点，可通过以下间接方式实现：

1. 创建文件新版本并替换元数据：使用POST /data/v1/projects/{project_id}/items/{item_id}/relationships/refs上传同一文件的新版本，同时在请求体中指定新的name和description，新版本会覆盖旧版本的元数据（版本历史会保留）。
2. 批量更新接口：若需批量修改多个文件描述，可使用POST /data/v1/projects/{project_id}/batch接口，将多个PATCH操作打包提交，提升效率。

内容的提问来源于stack exchange，提问作者Dhirendra Patil