Smartsheet（スマートシート）がドキュメントから誤ったsheetIdとrowIdを削除

Smartsheet（スマートシート）は2026年4月7日にオンライン開発者向けドキュメントを更新し、データモデルで使用されている2つのコアオブジェクトのスキーマエントリーを修正した。この変更は、行とセルのスキーマ記述の誤りに対処するもので、ドキュメントチームは誤って含まれていたプロパティを削除した。このアドバイザリーでは、以前にリストされていたプロパティはそれぞれのスキーマには属しておらず、公開ドキュメントと実際のオブジェクト定義との整合性を回復するために削除されたことが明確にされている。この更新は、基となるデータモデル自体の変更ではなく、ドキュメントの修正として位置付けられており、特に誤ってドキュメント化されていた2つのプロパティを対象としている。

最初の修正では、行スキーマからsheetIdが削除された。ドキュメントの改訂により、行はsheetIdプロパティを介してシートへの直接参照を保持しないこと、および以前のドキュメントにこのフィールドが存在していたことが誤りであったことが明確化された。行スキーマエントリーからsheetIdを削除することで、ドキュメントは行オブジェクトが明示的なシートレベルの識別子を含むものではないことを反映するようになった。この変更は、行オブジェクト上の直接的なシート参照を表していないにもかかわらずドキュメントに表示されていた属性を削除する、スキーマの説明の修正として提示された。この修正はスキーマテキストの範囲に限定され、マニフェストの削除は、行オブジェクトが公開するはずのプロパティに関する混乱を防ぐことを目的としていた。

2つ目の修正では、セルスキーマからrowIdを削除した。ドキュメントの更新では、セルにはrowIdプロパティを介した直接的な行参照は含まれておらず、以前のドキュメントの記載が不正確であったことが明記された。セルスキーマのエントリーからrowIdが削除されたことで、ドキュメントでは、セルオブジェクトには独立した行識別子プロパティは含まれていないことが示されるようになった。ドキュメント作成チームは、これをエラー修正として提示し、以前はドキュメント化されたセルオブジェクトの一部ではない直接的なリンクを示唆していたフィールドを削除した。この修正はスキーマドキュメントに限定され、公開されたセルスキーマにはrowIdがドキュメント化された属性として含まれていないことが明示されている。

これら2つの編集を合わせると、行とセルオブジェクトのスキーマドキュメントを重点的に整理したことになる。公開された注記では、ドキュメントに誤ったプロパティが含まれていたこと、そしてそれらのプロパティを削除して記録を修正したことが強調されている。今回の改訂では、行のsheetIdとセルのrowIdという直接的な関係への誤った参照を排除することに重点が置かれており、ドキュメントが意図したスキーマの説明をより正確に反映するようになっている。更新されたドキュメントを参照する読者は、行およびCellスキーマのエントリーにこれらの非推奨フィールドが記載されていないことに気付くだろう。また、公開された更新では、今回の調整は新しいフィールドの追加やオブジェクト自体の動作変更ではなく、以前のドキュメントの誤りを修正したものであると説明されている。

出典：Smartsheet