グループの所属ユーザーを取得する

目次

グループの所属ユーザーを取得する

グループの所属ユーザーを取得します。

CSVファイルをエクスポートするAPIはありません。

URL

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

HTTP メソッド

GET

必要なアクセス権

なし

リクエスト

パラメーター
パラメーター名 必須 説明
code 文字列 必須 グループコード
size 数値 省略可 取得する所属ユーザーの件数
1から100まで指定できます。省略すると 100 が設定されます。
offset 数値 省略可 取得する所属ユーザーの先頭からスキップする数
0から無限大の数値を指定できます。
省略すると、0が設定されます。
リクエストの例
URL

https://sample.cybozu.com/v1/group/users.json?code=Recruit2022

ヘッダー
1
2
3
{
  "X-Cybozu-Authorization": "QWRtaW5pc3RyYXRvcjpjeWJvenU="
}

リクエストヘッダーの詳細は User API の共通仕様を参照してください。

レスポンス

プロパティ
プロパティ名 説明
users 配列 グループの所属ユーザーの情報
詳細は User 型を参照してください。
レスポンスの例
 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
{
  "users": [
    {
      "id": "1",
      "code": "sato-noboru",
      "ctime": "2019-04-01T00:33:58Z",
      "mtime": "2023-03-31T04:37:39Z",
      "valid": true,
      "name": "佐藤 昇",
      "surName": "佐藤",
      "givenName": "昇",
      "surNameReading": "さとう",
      "givenNameReading": "のぼる",
      "localName": "",
      "localNameLocale": "ja",
      "timezone": "Asia/Tokyo",
      "locale": "ja",
      "description": "",
      "phone": "0000-000-0000",
      "mobilePhone": "090-000-0000",
      "extensionNumber": "",
      "email": "sato-noboru@example.com",
      "callto": "",
      "url": "",
      "employeeNumber": "",
      "birthDate": "1991-04-17",
      "joinDate": "2020-04-01",
      "primaryOrganization": "9",
      "sortOrder": null,
      "customItemValues": [
        {
          "code": "boss",
          "value": "2"
        }
      ]
    }
  ]
}

サンプルコード

curl を使ったリクエスト
1
2
curl -X GET 'https://sample.cybozu.com/v1/group/users.json?code=Recruit2022' \
  -H 'X-Cybozu-Authorization: QWRtaW5pc3RyYXRvcjpjeWJvenU='

制限事項

  • kintoneのゲストユーザーは取得できません。