Smartsheet(スマートシート)は、APIにおける「VIEWER」シートタイプの完全廃止と「CONTRIBUTOR」への移行、クロスシート参照作成に必要なアクセススコープのドキュメント修正、およびワークスペース複製時の`include`パラメーターの挙動明確化に関する3件の変更を公開した。
[VIEWERシートタイプの廃止とCONTRIBUTORへの移行]
社内の無料枠ユーザー向けの「VIEWER」シートタイプがSmartsheet APIから完全に削除され、「CONTRIBUTOR」に置き換えられた。
・APIレスポンスおよびプランのウェブフックコールバックにVIEWERは表示されなくなり、全ての社内無料枠ユーザーに対してCONTRIBUTORが返されるようになった。
・`seatType=VIEWER`によるフィルタリングや、ダウングレードリクエストのボディーでの`seatType: VIEWER`の指定はサポートされなくなった(代わりにCONTRIBUTORを使用する)。
・移行期間中にCONTRIBUTORレスポンスをオプトインするために必要だった`displayContributorSeatType`クエリーパラメーターは、`GET /2.0/users`および`GET /2.0/users/{userId}/plans`から削除された。
[クロスシート参照作成に関するドキュメントの修正]
`POST /2.0/sheets/{sheetId}/crosssheetreferences`(クロスシート参照の作成)の操作において、必要なOAuth2アクセススコープが`CREATE_SHEETS`ではなく`WRITE_SHEETS`であることを反映するよう仕様が修正された。
[ワークスペース複製時のincludeパラメーターの挙動明確化]
`POST /2.0/workspaces/{workspaceId}/copy`(ワークスペースのコピー)操作における`include`クエリーパラメーターのドキュメントが更新され、以下の仕様が明記された。
・`all`の値を指定しても、自動化ルール(`rules`)やその受信者(`ruleRecipients`)はコピーされない。
・`all`と一緒に`rules`や`ruleRecipients`を指定した場合でもコピーは行われない。
・自動化ルールおよびその受信者をコピーする場合は、`all`を除外し、明示的に`rules`および`ruleRecipients`(ルールのみの場合は`rules`)を指定する必要がある。
出典:Smartsheet
この製品の詳細については、Smartsheet製品ページをご覧ください。