cybozu.com共通APIドキュメント

ユーザーを更新する

目次

ユーザーを更新する

固定リンクがコピーされました

ユーザーを更新します。
一度に更新できるユーザーは、100件までです。

CSVファイルをインポートするAPIの詳細は、次のページを参照してください。
ユーザー情報をインポートする

URL

固定リンクがコピーされました

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

HTTPメソッド

固定リンクがコピーされました

PUT

必要なアクセス権

固定リンクがコピーされました

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

リクエスト

固定リンクがコピーされました

パラメーター
パラメーター名 型 必須 説明
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：スペイン語
  • pt-BR：ポルトガル語（ブラジル）
  • th：タイ語
  • auto：Webブラウザーの設定に従う
省略した場合、「Webブラウザーの設定に従う」と同じです。
users[].localName 文字列 省略可 別言語での表示名
128文字以下で指定します。
users[].localNameLocale 文字列 省略可 別言語での表示名（言語）
次の値を指定できます。
  • ja：日本語
  • en：英語
  • zh：中国語（簡体字）
  • zh-TW：中国語（繁体字）
  • es：スペイン語
  • pt-BR：ポルトガル語（ブラジル）
  • th：タイ語
users[].timezone 文字列 省略可 タイムゾーン
指定できる値は次のページを参照してください。
タイムゾーンの一覧 (External link)
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を実行する必要があります。
ユーザーが所属する組織は次のAPIで更新できます。
ユーザーが所属する組織を更新するAPI
users[].sortOrder 数値 省略可 表示優先度
0から99,999,999までの数値で指定します。
users[].customItemValues 配列（CustomItemValue型）
CustomItemValue型 		省略可 カスタマイズ項目の情報
リクエストの例
ヘッダー

APIトークンを利用する場合、スコープが「Read and Write」以上のトークンが必要です。
また、更新情報にAdministratorsグループの所属ユーザーを含む場合はスコープが「Dangerous Zone」のトークンが必要です。

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
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を使ったリクエスト

ご利用の環境によって、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
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 'Authorization: Bearer API_TOKEN' \
  -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の実行を並行して行うことは推奨しません。
    • 組織とユーザーの設定画面における、ユーザーに対する各操作
    • ファイルからの読み込み