kintone API文件

變更空白欄的設定

information

本頁面使用機器翻譯而成。
機器翻譯免責聲明 (External link)

目錄

變更空白欄的設定

連結已複製

變更空白欄的設定。

URL

連結已複製

正常空間
https://sample.cybozu.com/k/v1/space.json
訪客空間
https://sample.cybozu.com/k/guest/GUEST_SPACE_ID/v1/space.json

HTTP 方法

連結已複製

PUT

所需存取權限

連結已複製

  • 空間管理員

請求

連結已複製

參數
參數名稱 類型 必須 說明
id 數值或字串 必須 空間ID
name 字串 可省略 空間名稱
如果未指定，請不要更新。
isPrivate 布爾值 可省略 是否更新到私有空間
  • true： 非公開空間
  • false： 公開空間

如果未指定，請不要更新。
fixedMember 布爾值 可省略 是否禁止個人使用者取消訂閱/取消關注空間
  • true：禁止
  • false：不禁止

如果未指定，請不要更新。
useMultiThread 布爾值 可省略 是否更新到多主題空間
  • true：多主題空間

如果未指定，則為 false 或不更新。
showAnnouncement 布爾值 可省略 是否在多主題空間中顯示門戶的「公告」
  • true：顯示
  • false：不顯示
showThreadList 布爾值 可省略 是否在多主題空間中顯示門戶的「主題清單」
  • true：顯示
  • false：不顯示
showAppList 布爾值 可省略 是否在多主題空間中展示門戶的「應用程式清單」
  • true：顯示
  • false：不顯示
showMemberList 布爾值 可省略 是否在多主題空間中顯示門戶的「人員清單」
  • true：顯示
  • false：不顯示
showRelatedLinkList 布爾值 可省略 是否在多主題空間中顯示門戶的「相關連結清單」
  • true：顯示
  • false：不顯示
permissions 物件 可省略 空間許可權
permissions.createApp 字串 可省略 可以創建應用程式的使用者
  • EVERYONE：所有使用者
  • ADMIN：空間管理員

如果未指定，請不要更新。
示例請求
標頭
1
2
3
4

{
  "X-Cybozu-Authorization": "QWRtaW5pc3RyYXRvcjpjeWJvenU=",
  "Content-Type": "application/json"
}

有關請求頭的詳細資訊，請參閱通用規格。
kintone REST API通用規範

正文
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

{
  "id": 123,
  "name": "空間名稱",
  "isPrivate": true,
  "fixedMember": true,
  "useMultiThread": true,
  "showAnnouncement": true,
  "showThreadList": true,
  "showAppList": true,
  "showMemberList": true,
  "showRelatedLinkList": true,
  "permissions": {
    "createApp": "EVERYONE"
  }
}

回應

連結已複製

1

{}

樣本

連結已複製

使用 curl 的請求

根據您的環境，curl 的格式可能會有所不同。
有關說明，請參閱以下頁面。
使用curl命令執行kintone REST API/3.執行API 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

curl -X PUT 'https://sample.cybozu.com/k/v1/space.json' \
  -H 'X-Cybozu-Authorization: QWRtaW5pc3RyYXRvcjpjeWJvenU=' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": 123,
    "name": "空間名稱",
    "isPrivate": true,
    "fixedMember": true,
    "useMultiThread": true,
    "showAnnouncement": true,
    "showThreadList": true,
    "showAppList": true,
    "showMemberList": true,
    "showRelatedLinkList": true
    "permissions": {
      "createApp": "EVERYONE"
    }
  }'
使用kintone.api()發送請求

有關詳細的kintone.api()，請參閱以下頁面。
發送kintone REST API請求 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

const body = {
  id: 123,
  name: 空間名稱,
  isPrivate: true,
  fixedMember: true,
  useMultiThread: true,
  showAnnouncement: true,
  showThreadList: true,
  showAppList: true,
  showMemberList: true,
  showRelatedLinkList: true,
  permissions: {
    createApp: 'EVERYONE'
  }
};

await kintone.api(kintone.api.url('/k/v1/space.json', true), 'PUT', body);