共通管理API

使用者所屬的群組(角色)

目錄

使用者所屬的群組(角色)

使用者所屬的群組(角色)

有關導入CSV檔的API的詳細內容,請參考以下頁面。
匯入使用者所屬的群組(角色)

URL

https://sample.cybozu.com/v1/user/groups.json

HTTP 方法

PUT

所需存取權限

cybozu.com共通管理員 (External link)

請求

參數
參數名稱 類型 必須 說明
code 字串 必須 登入名稱
指定不超過 128 個字元
groups 陣列 必須 用戶所屬的組(角色)的組代碼清單
您最多可以指定 1,000 個專案。
更新使用者所屬的組(角色)時,請指定所有已指定的組代碼。
否則,它將從組中刪除。
如果要使用戶脫離關聯,請指定一個空陣列。
不能指定動態群組。
動態群組(僅可在kinkone使用) (External link)
示例請求
標頭

如果要使用API權杖,則需要權限範圍為「DangerousZone」的權杖。

1
2
3
4
{
  "Authorization": "Bearer API_TOKEN",
  "Content-Type": "application/json"
}

有關請求頭的更多資訊,請參閱以下頁面。
User API通用規範

內文
1
2
3
4
{
  "code": "sato-noboru",
  "groups": ["recruit2022", "recruit2023"]
}

回應

1
{}

示例代碼

使用curl的請求

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

1
2
3
4
5
6
7
curl -X PUT 'https://sample.cybozu.com/v1/user/groups.json' \
  -H 'Authorization: Bearer API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
        "code": "sato-noboru",
        "groups": ["recruit2022", "recruit2023"]
      }'

限制事項

  • 不建議在cybozu.com共通管理中執行API的同時,執行以下操作。
    • 組織和使用者設置畫面上的使用者操作
    • 從檔案匯入