更新使用者

連結已複製

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

更新使用者

連結已複製

更新使用者。
一次最多只能選擇100個使用者。

有關導入 CSV 檔的 API 的詳細資訊，請參閱導入使用者資訊。

URL

連結已複製

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

HTTP 方法

連結已複製

PUT

所需許可權

連結已複製

cybozu.com共通管理員

請求

連結已複製

參數

參數名稱	型	必須	說明
users	陣列	必須	訪客資訊的編輯
users[].code	字串	必須	登入名稱指定不超過 128 個字元。不能指定空格或僅指定空格。
users[].valid	布爾值	自選	使用者使用方式 `true`：使用中 `false`：使用停止中如果省略，則設置為「true」。
users[].password	字串	自選	密碼指定不超過 64 個字元無法指定空白字串。
users[].name	字串	自選	顯示名稱指定不超過 128 個字元。不能指定空格或僅指定空格。
users[].surName	字串	自選	姓指定不超過 64 個字元。
users[].givenName	字串	自選	名字指定不超過 64 個字元。
users[].surNameReading	字串	自選	拼音（姓）指定不超過 64 個字元。
users[].givenNameReading	字串	自選	拼音（名）指定不超過 64 個字元。
users[].locale	字串	自選	語言您可以指定以下值： `ja`：日本語 `en`：英語 `zh`：中文（簡體） `zh-TW`：中文（繁體） `es`：西班牙文與網路瀏覽器的設定相同如果省略，則與「遵循 Web 瀏覽器設置」相同。
users[].localName	字串	自選	其他語言下的顯示名稱指定不超過 128 個字元。
users[].localNameLocale	字串	自選	其他語言下的顯示名稱您可以指定以下值： `ja`：日本語 `en`：英語 `zh`：中文（簡體） `zh-TW`：中文（繁體） `es`：西班牙文
users[].timezone	字串	自選	時區請參閱時區的可能值清單。
users[].description	字串	自選	新增使用者指定不超過 1,000 個字元。
users[].phone	字串	自選	電話號碼指定100個字元或更少。
users[].mobilePhone	字串	自選	手機號碼指定100個字元或更少。
users[].extensionNumber	字串	自選	外延指定100個字元或更少。
users[].email	字串	自選	電子郵件地址指定不超過 256 個字元。
users[].callto	字串	自選	Skype 可能的值受 Skype 約束的約束。
users[].url	字串	自選	URL 指定不超過 256 個字元。
users[].employeeNumber	字串	自選	員工編號指定100個字元或更少。
users[].birthDate	日期	自選	生日您可以指定格式為"YYYY-MM-DD"的日期，也可以僅指定空字串。
users[].joinDate	日期	自選	到職日您可以指定格式為"YYYY-MM-DD"的日期，也可以僅指定空字串。
users[].primaryOrganization	數值	自選	優先組織指定使用者所屬組織的組織ID，即首選組織。在運行此 API 之前，您必須設置使用者所屬的組織。您可以使用更新使用者所屬的組織來更新使用者所屬的組織。
users[].sortOrder	數值	自選	顯示優先度指定一個介於 0 和 99,999,999 之間的數位。
users[].customItemValues	陣列（類型CustomItemValue）	自選	新增自訂項目

示例請求

頁眉

1
2
3
4


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

有關請求頭的詳細資訊，請參閱通用使用者 API 規範。

身體

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35


{
  "users": [
    {
      "code": "kato-misaki",
      "valid": true,
      "password": "password",
      "name": "加藤 美咲",
      "surName": "加藤",
      "givenName": "美咲",
      "surNameReading": "加藤",
      "givenNameReading": "美咲",
      "localName": "",
      "localNameLocale": "ja",
      "timezone": "Asia/Tokyo",
      "locale": "ja",
      "description": "",
      "phone": "0000-00-0000",
      "mobilePhone": "",
      "extensionNumber": "",
      "email": "kato-misaki@example.com",
      "callto": "",
      "url": "",
      "employeeNumber": "m00312",
      "birthDate": "1991-04-17",
      "joinDate": "2022-04-01",
      "sortOrder": null,
      "customItemValues": [
        {
          "code": "boss",
          "value": "1"
        }
      ]
    }
  ]
}

回應

連結已複製

1

{}

示例代碼

連結已複製

使用 curl 的請求

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38


curl -X PUT 'https://sample.cybozu.com/v1/users.json' \
  -H 'X-Cybozu-Authorization: QWRtaW5pc3RyYXRvcjpjeWJvenU=' \
  -H 'Content-Type: application/json' \
  -d '{
    "users": [
      {
        "code": "kato-misaki",
        "valid": true,
        "password": "password",
        "name": "加藤 美咲",
        "surName": "加藤",
        "givenName": "美咲",
        "surNameReading": "加藤"，
        "givenNameReading": "美咲"，
        "localName": "",
        "localNameLocale": "ja",
        "timezone": "Asia/Tokyo",
        "locale": "ja",
        "description": "",
        "phone": "0000-00-0000",
        "mobilePhone": "",
        "extensionNumber": "",
        "email": "kato-misaki@example.com",
        "callto": "",
        "url": "",
        "employeeNumber": "m00312",
        "birthDate": "1991-04-17",
        "joinDate": "2022-04-01",
        "sortOrder": null,
        "customItemValues": [
          {
            "code": "boss",
            "value": "1"
          }
        ]
      }
    ]
  }'

限制

連結已複製

cybozu.com 不建議您在「管理通用」中執行以下操作並並行執行API。
- 組織和用戶設置螢幕上的使用者操作
- 從檔案匯入

cybozu.com 通用 API 文件

更新使用者

目錄

更新使用者

URL

HTTP 方法

所需許可權

請求

參數

示例請求

頁眉

身體

回應

示例代碼

使用 curl 的請求

限制