Autodesk Docs/BIM 360 Docs に保存されているファイルをダウンロードする際に、Data Management API をご利用ですか？
Docs に保存されている Revit モデルをダウンロードすると、ZIP ファイルが生成される場合があることをご存知ですか？
お使いの APS アプリケーションは、これらの .rvt ファイルを解析して、さらに処理を行っていますか？
Autodesk は、公開されている Revit Cloud Model (RCM) のダウンロード方法を変更致しました。この変更の影響を受ける APS アプリケーションを使用している場合は、コードを更新する必要があります。
背景
Autodesk Docs/BIM 360 Docs から Revit モデルをダウンロードすると、ファイルは単一の Revit ファイル（.rvt）または ZIP ファイル（.zip）としてダウンロードされます。これは、Revit にはホストモデルが他のモデルにリンクされている、いわゆるリンクモデルの概念があるためです。
ホストモデルを公開する際、Revit は参照するリンクファイルが同期され、最新版として公開されているかどうかを確認します。
同期されている場合、ホストモデルは .rvt ファイルとして公開されます。同期されていない場合（つまり、参照するリンクファイルがまだ最新版として公開されていない場合）、リンクファイルの未公開バージョンを含む ZIP ファイルが作成されます。
この製品の動作に関する詳細な説明については、こちらの記事を参照してください。
前述のリンクモデルのダウンロードは複雑で、混乱を招く可能性があります。
この問題を解決するため、Autodesk は2025年6月に新しい API エンドポイント「GET linked Revit files」をリリースしました。
GET /construction/rcm/v1/projects/{projectId}/published-versions/{versionId}/linked-files
このエンドポイントを使用すると、開発者はホストモデルとリンクされたファイルの署名付き URL を、公開ステータスに関係なく取得できます。
これにより、AWS S3 から直接ファイルをダウンロードできます。
このアプローチは、今後、リンクされたモデルのダウンロードワークフローを大幅に強化します。このエンドポイントの使用方法の詳細については、こちらのブログ投稿をご覧ください。
注意: 「リンクされた Revit ファイルの取得」エンドポイントは
、2025 年 2 月 7 日以降に公開された RCM のみをサポートします。
これから何が起こりますか
リンクされた RCM のダウンロードエクスペリエンスを向上させるための継続的な取り組みとして、オートデスクは新たな変更を実施します。
この変更は、リンクされたモデルを ZIP ファイルに含めることで生じる混乱を解消することを目的としています。
2026年2月15日以降に公開された Revit クラウドモデル（RCM）は、未公開のリンクモデルを含む ZIP ファイルとしてダウンロードできなくなります。
ダウンロードは常にホストモデル（.rvt）ファイルのみとなります。
注: 2026 年 2 月 15 日より前に公開された RCM は、引き続き ZIP ファイルとしてダウンロードできます。
どのような影響がありますか
アプリケーションで未公開のリンクファイルを含む RCM が必要な場合は、公開日時に応じて2つのワークフローをサポートするようにコードを更新する必要があります。Revit リンクモデルのバージョンIDは次のとおりです。
- 「createTime」が 2025年2月7日より前 の場合は、ZIP としてダウンロードします（レガシー）
- 「createTime」が 2025年2月7日以降 の場合は、「GET linked Revit file」（新規）を使用してダウンロードします。
2025年2月7日から2026年2月15日までは移行期間となります。この期間中は、両方のワークフローがサポートされます。
必要なアクション
現在、アプリケーションで ZIP ダウンロードを処理し、リンクされたファイルを取得する必要がある場合は、
2026年2月15日までに、上記の2つのワークフローをサポートしてリンクをダウンロードできるようにコードを更新する必要があります。
この日以降、Autodesk Docs/BIM 360 Docs に新たに公開される RCM バージョンでは、ZIP ファイルがダウンロード可能ではなくなり、ZIP ファイルを使用した現在のワークフローは機能しなくなります。
疑似コードによるワークフローの解説
以下では、従来の方法と新しい方法のどちらを使用するべきかを擬似コードを用いて判断するワークフローを説明します。
例えば、ファイルのバージョンIDが与えられた場合、Data Management API を使用したファイルバージョンのレスポンスは次のようになります。
{ "type": "versions", "id": "urn:adsk.wipprod:fs.file:vf.UcS7SqoCQaaFH2q7eOmWwA?version=6", "attributes": { "name": "Sample2025.rvt", "displayName": "Sample2025.rvt", "createTime": "2025-06-25T20:52:11.0000000Z", "createUserId": "4V4WKQJGGQ7N", "createUserName": "Zhong Wu", "lastModifiedTime": "2025-06-25T20:53:39.0000000Z", "lastModifiedUserId": "4V4WKQJGGQ7N", "lastModifiedUserName": "Zhong Wu", "versionNumber": 6, "mimeType": "application/vnd.autodesk.r360", "storageSize": 77254407, "fileType": "rvt", "extension": { "type": "versions:autodesk.bim360:C4RModel", "version": "1.3.3", "schema": { "href": "https://developer.api.autodesk.com/schema/v1/versions/versions:autodesk.bim360:C4RModel-1.3.3" }, "data": { "modelVersion": 6, "isCompositeDesign": true, "mimeType": "application/vnd.autodesk.r360", "revitProjectVersion": 2025, "compositeParentFile": "Sample2025.rvt", "projectGuid": "1576aefe-dae2-4ef5-a2f4-293ae681ad70", "publishType": "Hybrid", "originalItemUrn": "urn:adsk.wipprod:dm.lineage:UcS7SqoCQaaFH2q7eOmWwA", "modelType": "multiuser", "latestEpisodeGuid": "a21bcced-17e3-4da1-9a7e-fabd46d6988e", "modelGuid": "a61ea1eb-c1f3-4cd5-9c34-bcf5a1009f42", "processState": "PROCESSING_COMPLETE", "extractionState": "SUCCESS", "splittingState": "NOT_SPLIT", "reviewState": "NOT_IN_REVIEW", "revisionDisplayLabel": "6", "sourceFileName": "Sample2025.rvt", "conformingStatus": "NONE" } } },}
ファイルが RCM であるかどうかを確認します。つまり、
if (attributes.fileType==”rvt” && “attributes.extension.type=="versions:autodesk.bim360:C4RModel") then the file is RCM file. else, the download is the same as other file format.
(ケース 1) ファイルが 2025 年 2 月 7 日より前に公開される場合は、従来のワークフローを使用します。
if (attributes.createTime < "2025-02-07T00:00:00.0000000Z") then use the legacy workflow. if (attributes.extention.data.isCompositeDesign == true) then download will be zip.
(ケース 2) ファイルが 2025 年 2 月 7 日以降に公開される場合は、新しいワークフローを使用します。
if (attributes.createTime >= "2025-02-07T00:00:00.0000000Z") then use the new workflow. Use “GET linked Revit files” endpoint with “includeHost==true” query parameter. // This will work for both with/without linked file.
注: ファイルが2025年6月25日以降に公開された場合、新しいフィールド「attributes.extention.data.hasLinks」が追加されます。このフィールドが true の場合、モデルにはリンクされたファイルがあります。
ご不明な点がございましたら、 APS サポートまでお問い合わせください。
※ 本記事は Changes are coming for Revit Cloud Model Downloads from Autodesk/BIM 360 Docs – starting February 15, 2026 | Autodesk Platform Services から転写・意訳、補足したものです。
Leave a Reply