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

ユーザーが所属するグループ（ロール）を取得する

目次

ユーザーが所属するグループ（ロール）を取得する

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

ユーザーが所属するグループ（ロール）を取得します。

CSVファイルをエクスポートするAPIの詳細は、次のページを参照してください。
ユーザーが所属するグループ（ロール）をエクスポートする

URL

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

https://sample.cybozu.com/v1/user/groups.json

HTTPメソッド

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

GET

必要なアクセス権

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

なし

リクエスト

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

パラメーター
パラメーター名 型 必須 説明
code 文字列 必須 ユーザーのログイン名
リクエストの例
URL

https://sample.cybozu.com/v1/user/groups.json?code=sato-noboru

ヘッダー

APIトークンを利用する場合、指定するスコープにかかわらず実行可能です。

1
2
3

{
  "Authorization": "Bearer API_TOKEN"
}

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

レスポンス

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

プロパティ
プロパティ名 型 内容
groups 配列 ユーザーが所属するグループ（ロール）の一覧
詳細は次のページを参照してください。
Group型
レスポンスの例
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

{
  "groups": [
    {
      "id": "1",
      "code": "recruit2022",
      "name": "2022年度採用プロジェクト",
      "description": "2022年度採用プロジェクト"
    },
    {
      "id" : "7532782697181632513",
      "code" : "everyone",
      "name" : "Everyone",
      "description" : ""
    }
  ]
}

サンプルコード

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

curlを使ったリクエスト

ご利用の環境によって、curlのフォーマットは異なる場合があります。
詳細は、次のページを参照してください。
curlコマンドでkintone REST APIを実行してみよう/3.API実行 

1
2

curl -X GET 'https://sample.cybozu.com/v1/user/groups.json?code=sato-noboru' \
  -H 'Authorization: Bearer API_TOKEN'

制限事項

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

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