更新屬於某群組個組的使用者

information

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

目錄

更新屬於某個群組的使用者

更新屬於某個群組的使用者。

沒有用於導入 CSV 檔案的 API。

URL

https://sample.cybozu.com/v1/group/users.json

HTTP 方法

PUT

所需存取權限

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

請求

參數
參數名稱 類型 必須 說明
code 字串 必須 群組代碼
指定不超過 128 個字元
不能指定動態群組。
users 陣列(字串) 必須 屬於該群組的使用者的登錄名清單
您最多可以指定 1,000 個專案。
更新屬於某個群組的使用者時,請確保還指定了已指定的所有登錄名。
否則,它將從組中刪除。
若要從組中刪除所有使用者,請指定一個空陣列。
示例請求
標頭

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

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

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

內文
1
2
3
4
{
  "code": "Recruit2022",
  "users": ["sato-noboru", "kato-misaki"]
}

回應

1
{}

示例代碼

使用 curl 的請求

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

1
2
3
4
5
6
7
curl -X PUT 'https://sample.cybozu.com/v1/group/users.json' \
  -H 'Authorization: Bearer API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
        "code": "Recruit2022",
        "users": ["sato-noboru", "kato-misaki"]
      }'
限制
  • 無法更新屬於動態群組的使用者。
    若要變更使用者成員身份,請編輯動態群組條件。
    指定動態群組的條件 (External link)
  • 不建議在cybozu.com共通管理中執行以下操作並行執行 API:
    • 群組設置畫面上的各項操作
    • 從檔案匯入