cybozu.com 共通 API 文件

更新使用者所屬的組織

information

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

目錄

更新使用者所屬的組織

連結已複製

更新使用者所屬的組織。

有關導入CSV檔的API的詳細內容，請參考以下頁面。
匯入使用者所屬的組織

URL

連結已複製

https://sample.cybozu.com/v1/userOrganizations.json

HTTP方法

連結已複製

PUT

所需存取權限

連結已複製

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

請求

連結已複製

參數
參數名稱 類型 必須 說明
userOrganizations 陣列 必須 使用者所屬組織的資訊
最多可以指定100個。
userOrganizations[].code 字串 必須 登入名稱
指定不超過128個字元
userOrganizations[].organizations 陣列 必須 使用者所屬的組織
最多可以指定100個。
更新使用者所屬的組織時，請確保還指定了已指定的任何組織。
否則，它將從組織中刪除。
如果讓使用者不屬於任何組織，請指定一個空陣列。
userOrganizations[].organizations[].orgCode 字串 部分條件下必須 組織代碼
指定不超過128個字元
如果userOrganizations[].organizations[].titleCode指定，則為必填項。
userOrganizations[].organizations[].titleCode 字串 可省略 職務代碼
指定不超過128個字元
如果省略，則將其設置為無標題。
示例請求
標頭

使用API權杖時，需要權限範圍為「Read and Write」或更高權限範圍的權杖。

1
2
3
4

{
  "Authorization": "Bearer API_TOKEN",
  "Content-Type": "application/json"
}

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

內文
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

{
  "userOrganizations": [
    {
      "code": "kato-misaki",
      "organizations": [
        {
          "orgCode": "Sales01",
          "titleCode": "TeamLeader"
        }
      ]
    }
  ]
}

回應

連結已複製

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

curl -X PUT 'https://sample.cybozu.com/v1/userOrganizations.json' \
  -H 'Authorization: Bearer API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "userOrganizations": [
      {
        "code": "kato-misaki",
        "organizations": [
          {
            "orgCode": "Sales01",
            "titleCode": "TeamLeader"
          }
        ]
      }
    ]
  }'

限制事項

連結已複製

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