`versions:batch-get` 不获取“标题”自定义属性

Question

我一直试图在我的项目的计划文件夹中获取文档的“标题”属性，但工作表 number/displayName 出现在响应的 title 字段中：

{
  "urn": "urn:adsk.wipprod:fs.file:[...]version=1",
  "itemUrn": "urn:adsk.wipprod:dm.lineage:[...]",
  "name": "A13.3",
  "title": "A13.3", // <- Here
  "...": "...",
  "customAttributes": [], // <- Nothing here, even if I modify the "Title value"
  "number": "A13.3"
  
}

这是故意的吗？还是我误会了？我找不到任何其他有文档表明它将获取 Title 属性的端点。我看到 BIM360 网络应用程序正在使用 legacy endpoint 为自己获取此属性：

projects/:project_id/folders/:folder_id/custom_attributes.

我知道这类似于 previous question，但似乎是在一年前没有 versions:batch-get 端点时提出的。

提前谢谢你！

Answer 1

您提到的文档已过时。请改为检查这个：

https://forge.autodesk.com/en/docs/bim360/v1/reference/http/document-management-versionsbatch-get-POST

title、displayName 和 name 等字段是 Docs 内置的自定义属性，只会出现在 POST versions:batch-get 的响应中，而不是出现在 GET custom-attribute-definitions 中。

此外，POST versions:batch-get 和 GET custom-attribute-definitions 的 customAttributes 字段仅适用于 user-created custom attributes。如果您没有为 Docs 项目的文档或文件的用户创建的自定义属性分配任何值，则 customAttributes 字段将为空。这是来自documentation 的字段描述。

每个文档的自定义属性列表。有关自定义属性的详细信息，请参阅使用属性自定义文档文档。