變更應用程式的設定
打開應用程式的設定進行變更。
此 API 在測試環境中修改應用。
如果要將更改傳播到生產環境,請運行此 API,然後
運行將應用設置傳播到生產環境的 API 。
URL
- 常規應用
- https://sample.cybozu.com/k/v1/preview/app/views.json
- 建立訪客空間
- https://sample.cybozu.com/k/guest/
GUEST_SPACE_ID
/v1/preview/app/views.json
HTTP 方法
PUT
所需許可權
採用表格或日曆格式
- 應用程式管理
對於自定義格式
- kintone系統管理
請求
參數
參數名稱 | 指定值 | 必須 | 說明 |
---|---|---|---|
app | 數值 | 必須 | 應用ID |
views | 物件 | 必須 | 清單中的設置清單 添加或更新清單時,請在 中 views 指定現有清單。如果未指定,則刪除該清單。 |
views.一覧名 |
物件 | 必須 | 每個清單的設置
一覧名 為 指定 (Worker is me}, |
views.一覧名 .index |
字串 | 必須 | 清單順序 該清單按指定的數位升序排序。 |
views.一覧名 .type |
字串 | 必須 | 清單格式
|
views.一覧名 .name |
字串 | 條件必填項 | 新清單的名稱。 最多指定 64 個字元。 如果要添加新清單,則為必填項,請指定 一覧名 與 相同的值。 |
views.一覧名 .fields |
陣列 | 條件必填項 | 要顯示的欄位的欄位代碼清單 指定要顯示的每個欄位的欄位代碼。 views.一覧名.type 如果為"LIST",則為必填項。 |
views.一覧名 .date |
字串 | 自選 | 要用作日期的欄位的域代碼views.一覧名.type 是"日曆"。如果省略,則設置修改後的日期和時間欄位。 |
views.一覧名 .title |
字串 | 自選 | 要用作標題的欄位的域代碼views.一覧名.type 是"日曆"。如果省略,則設置記錄編號欄位。 |
views.一覧名 .html |
字串 | 自選 | 用於自訂的 HTML 內容views.一覧名.type 是"CUSTOM"。 |
views.一覧名 .pager |
布爾值 | 自選 | 分頁顯示
views.一覧名.type 是"CUSTOM"。如果省略,則設置為「true」。 |
views.一覧名 .device |
字串 | 自選 | 清單的顯示範圍
views.一覧名.type 是"CUSTOM"。如果省略,將設置"DESKTOP"進行添加,並且更改時保持不變。 |
views.一覧名 .filterCond |
字串 | 自選 | 記錄精簡程式 以查詢格式指定。有關查詢格式,請參閱如何 編寫查詢 。 |
views.一覧名 .sort |
字串 | 自選 | 記錄排序 以查詢格式指定。有關查詢格式,請參閱如何 編寫查詢 。 |
revision | 數位或字串 | 自選 | 預期修訂號 如果它與實際修訂號不匹配,則會發生錯誤,並且清單中的設置不會更改。 如果指定值"-1"或未指定值,則不會驗證修訂號。 |
示例請求
頁眉
|
|
關於請求頭,請參見 kintone REST API的通用規範 。
身體
|
|
回應
財產
屬性名稱 | 型 | 說明 |
---|---|---|
views | 物件 | 信息清單 |
views.一覧名 .id |
字串 | 查看ID |
revision | 字串 | 更改應用設置后的修訂號 |
示例回應
|
|
示例代碼
使用 curl 的請求
|
|
發送kintone REST API請求 使用API 發送請求
|
|
限制
- 如果存在同名清單,則無法更改設置。
- 如果要修改具有顯示格式的「自定義格式」列表的應用,則不能使用 API 令牌。