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

User API で使用するデータ構造

目次

User API で使用するデータ構造

ID 型

エンティティの ID として使われる型です。
値域は、1 から Long.MAX です。

User 型

キー 型 内容
id ID 型 ユーザー ID
code 文字列 ログイン名
ctime 文字列 作成日時
ISO-8601 日時が返ります。
mtime 文字列 更新日時
ISO-8601 日時が返ります。
valid 真偽値 使用可能ユーザーかどうか
name 文字列 表示名
surName 文字列 姓
givenName 文字列 名
surNameReading 文字列 よみがな（姓）
givenNameReading 文字列 よみがな（名）
localName 文字列 別言語での表示名
localNameLocale 文字列 「別言語での表示名」で使用する言語
timezone 文字列 タイムゾーン (External link) の ID
locale 文字列 ロケール
description 文字列 メモ
phone 文字列 電話番号
mobilePhone 文字列 携帯電話番号
extensionNumber 文字列 内線番号
email 文字列 メールアドレス
callto 文字列 SkypeID
url 文字列 URL
employeeNumber 文字列 従業員番号
birthDate 文字列 誕生日
「YYYY-MM-DD」形式の日付文字列です。
未設定の場合は null です。
joinDate 文字列 入社日
「YYYY-MM-DD」形式の日付文字列です。
未設定の場合は null です。
primaryOrganization 数値 優先する組織
組織 ID です。
所属組織を設定していない場合は null です。
sortOrder 数値 表示優先度
customItemValues 配列（ CustomItemValue 型） カスタマイズ項目の項目コードと値
サンプル
 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

{
  "birthDate": "2011-05-01",
  "callto": "",
  "code": "a",
  "ctime": "2013-07-22T08:12:18Z",
  "customItemValues": [
    {
      "code": "item1",
      "value": "aitem1"
    },
    {
      "code": "secret",
      "value": "aitem2"
    }
  ],
  "description": "",
  "email": "",
  "employeeNumber": "",
  "extensionNumber": "",
  "givenName": "",
  "givenNameReading": "",
  "id": "1",
  "joinDate": "2013-01-01",
  "localName": "",
  "localNameLocale": "ja",
  "locale": "",
  "mobilePhone": "",
  "mtime": "2013-07-22T09:00:45Z",
  "name": "a",
  "phone": "",
  "primaryOrganization": null,
  "sortOrder": 2147483647,
  "surName": "a",
  "surNameReading": "",
  "timezone": "Asia/Tokyo",
  "url": "",
  "valid": true
}

Organization 型

キー 型 内容
id ID 型 組織 ID
code 文字列 組織コード
name 文字列 組織名
localName 文字列 別言語での表示名
localNameLocale 文字列 「別言語での表示名」で使用する言語
parentCode 文字列 親組織のコード
親が root の場合には 「null」が返ります。
description 文字列 メモ
サンプル
1
2
3
4
5
6
7
8
9

{
  "id": 1,
  "code": "DEV_ba27fP",
  "name": "DEV",
  "localName": "開発部",
  "localNameLocale": "ja",
  "parentCode": null,
  "descriptioon": "開発をする部署"
}

Title 型

キー 型 内容
id ID 型 役職 ID
code 文字列 役職コード
name 文字列 役職名
description 文字列 メモ
サンプル
1
2
3
4
5
6

{
  "id": 2,
  "code": "開発者_OLJ9P0",
  "name": "開発者",
  "descriptioon": "エンジニア"
}

Group 型

キー 型 内容
id ID 型 グループ ID
code 文字列 グループコード
name 文字列 グループ名
description 文字列 メモ
サンプル
1
2
3
4
5
6

{
  "id": 1,
  "code": "SALES01",
  "name": "東京営業部",
  "description": ""
}

OrganizationTitle 型

キー 型 内容
organization Organization 型 組織情報
title Title 型 役職情報
未設定の場合には、 null が返ります。
サンプル
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

{
  "organization": {
    "id": 1,
    "code": "DEV_ba27fP",
    "name": "DEV",
    "localName": "開発部",
    "localNameLocale": "ja",
    "parentCode": null,
    "descriptioon": "開発をする部署"
  },
  "title": {
    "id": 2,
    "code": "開発者_OLJ9P0",
    "name": "開発者",
    "descriptioon": "エンジニア"
  }
}

UserTitle 型

キー 型 内容
user User 型 ユーザ情報
title Title 型 役職情報
未設定の場合には、null が返ります。
サンプル
 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
39
40
41
42
43
44
45
46

{
  "user": {
    "birthDate": "2011-05-01",
    "callto": "",
    "code": "a",
    "ctime": "2013-07-22T08:12:18Z",
    "customItemValues": [
      {
        "code": "item1",
        "value": "aitem1"
      },
      {
        "code": "secret",
        "value": "aitem2"
      }
    ],
    "description": "",
    "email": "",
    "employeeNumber": "",
    "extensionNumber": "",
    "givenName": "",
    "givenNameReading": "",
    "id": "1",
    "joinDate": "2013-01-01",
    "localName": "",
    "localNameLocale": "ja",
    "locale": "",
    "mobilePhone": "",
    "mtime": "2013-07-22T09:00:45Z",
    "name": "a",
    "phone": "",
    "primaryOrganization": null,
    "sortOrder": 2147483647,
    "surName": "a",
    "surNameReading": "",
    "timezone": "Asia/Tokyo",
    "url": "",
    "valid": true
  },
  "title": {
    "id": 2,
    "code": "開発者_OLJ9P0",
    "name": "開発者",
    "descriptioon": "エンジニア"
  }
}

CustomItemValue 型

非公開に設定されたカスタマイズ項目は、cybozu.com 共通管理者のみ取得できます。

キー 型 内容
code 文字列 コード
value 文字列 値
サンプル
1
2
3
4

{
  "code": "item",
  "value": "item value"
}