Data Management API：ACC へのファイル アップロードの注意点

Data Management API を使って Fusion Team（含む 旧 BIM 360 Team・A360 Personal）や Autodesk Construction Cloud（Autodesk Docs、旧 BIM 360 Docs）などのオートデスクのストレージ サービスにファイルをアップロードを把握する際、公式ドキュメントの How-to Guide に記載されている Upload a File を参考にされると思います。

同ドキュメントに記載されている手順は、Fusion Team と Autodesk Construction Cloud で共通しています。ただし、Step 7: Create the first version of the uploaded file、Step 8: Update the version of a file で紹介されている cURL 使用のリクエスト ボディの JSON ペイロード内容には注意が必要です。

Step 7 の cURL 呼び出し例の場合：

curl -X POST -H "Authorization: Bearer nFRJxzCD8OOUr7hzBwbr06D76zAT" -H "Content-Type: application/vnd.api+json" -H "Accept: application/vnd.api+json" -d '{
    "jsonapi": { "version": "1.0" },
    "data": {
      "type": "items",
      "attributes": {
        "displayName": "myfile.jpg",
        "extension": {
          "type": "items:autodesk.core:File",
          "version": "1.0"
        }
      },
      "relationships": {
        "tip": {
          "data": {
            "type": "versions", "id": "1"
          }
        },
        "parent": {
          "data": {
            "type": "folders",
            "id": "urn:adsk.wipprod:fs.folder:co.mgS-lb-BThaTdHnhiN_mbA"
          }
        }
      }
    },
    "included": [
      {
        "type": "versions",
        "id": "1",
        "attributes": {
          "name": "myfile.jpg",
          "extension": {
            "type": "versions:autodesk.core:File",
            "version": "1.0"
          }
        },
        "relationships": {
          "storage": {
            "data": {
              "type": "objects",
              "id": "urn:adsk.objects:os.object:wip.dm.prod/2a6d61f2-49df-4d7b-9aed-439586d61df7.jpg"
            }
          }
        }
      }
    ]
  }' "https://developer.api.autodesk.com/data/v1/projects/a.cGVyc29uYWw6d2lwMWZxYWUyOWNlZGY4I0QyMDE2MDQxODM5NDM2NzM/items"

この Step で説明されているファイルのアップロード先は、Fusion Team（含む 旧 BIM 360 Team・A360 Personal）になっています。これは、扱っている Hub ID が a. で始まっている点で判別することが出来ます。ここでは、黄色で反転で示した Items と Versions スコープの type 値が、autodesk.core:File になってる点にも着目ください。

Autodesk Construction Cloud（Autodesk Docs、旧 BIM 360 Docs）の Hub ID は、b. で始まります。同様に、許容される Items と Versions スコープの type 値は、autodesk.bim360:File になります。

このため、 Upload a File 記載の JSON ペイロード内容の Hub ID、Folder ID、Object ID 等のみを変更して、そのまま Autodesk Construction Cloud にアップロードしたファイルにバージョンを与えようとすると、400 BAD_INPUT エラーでバージョン登録に失敗してしまいます。

Autodesk Construction Cloud へのバージョン登録には、autodesk.bim360:File を指定するようにしてください。

最初のバージョン登録（Step 7）時のリクエスト ボディの JSON ペイロード例：

{
    "jsonapi": {
      "version": "1.0"
    },
    "data": {
      "type": "items",
      "attributes": {
        "displayName": "result.pdf",
        "extension": {
          "type": "items:autodesk.bim360:File",
          "version": "1.0"
        }
      },
      "relationships": {
        "tip": {
          "data": {
            "type": "versions",
            "id": "1"
          }
        },
        "parent": {
          "data": {
            "type": "folders",
            "id": "urn:adsk.wipprod:fs.folder:co.FtKfsRS2Re6g0keqduq8tw"
          }
        }
      }
    },
    "included": [
      {
        "type": "versions",
        "id": "1",
        "attributes": {
          "name": "result.pdf",
          "extension": {
            "type": "versions:autodesk.bim360:File",
            "version": "1.0"
          }
        },
        "relationships": {
          "storage": {
            "data": {
              "type": "objects",
              "id": "urn:adsk.objects:os.object:wip.dm.prod/c6b4e59d-8315-451f-be83-afa751e8525b.pdf"
            }
          }
        }
      }
    ]
  }

By Toshiaki Isezaki