【API】代理人とチームメンバーの取得

更新 2026年05月28日 04:43

代理人とは、既存の組織階層を変更または崩すことなく、他のユーザーを管理できるユーザーを指します。

ラインマネージャーやプロキシマネージャーを含む、すべての Learn365 ユーザーを代理人として設定でき、組織内の任意のユーザーを管理することが可能です。代理人の詳細については、関連ドキュメントをご参照ください。

ここでは、Learn365 API を使用して、代理人とチームメンバーを取得する手順について説明します。

Learn365 API では、以下の 2 つの方法で代理人およびチームメンバーの情報を取得できます。

✅ すべての代理人とそのチームメンバーを取得する

✅ 特定の代理人とそのチームメンバーを取得する

すべての代理人とそのチームメンバーを取得する

手順：

1．API にアクセスし、認証を行います。

https://api.365.systems/ にアクセスし、適切な API キーで認証されていることを確認してください。

2．エンドポイントを選択します。

Delegates セクションで以下のエンドポイントを選択し、右上の［Try it out］をクリックします。

GET /services/users/v2/Delegates

3．必要に応じてパラメータを入力します。

レスポンスに含めるデータは、クエリオプションパラメータを使用して制御できます。

4．［Execute］をクリックしてリクエストを実行します。

5．「Responses」ブロックで結果を確認します。

ステータスコード 200 が返され、レスポンス本文に代理人デリゲートとチームメンバーの情報を含む配列が含まれている場合は成功です。
この配列では、各要素が代理人とチームメンバーの対応関係（割り当て）を表します。1 人の代理人が複数のチームメンバーを管理している場合、メンバーごとに別々のデータとして並べられます。（代理人 A が、メンバー B・C を管理している場合、「 A と B 」「 A と C 」のように、それぞれ別データになります。）

配列内の各要素には、以下のパラメータが含まれます。

delegateId (string)：代理人ユーザー ID
teamMemberId (string)：チームメンバーのユーザー ID
isDeleted (boolean)：代理人ユーザーの割り当てが削除されたかどうかを示します（true：削除済み、false：未削除）。
delegate (object) と teamMember (object). ：それぞれ代理人とチームメンバーに関する詳細情報が含まれます。
- id (string)：ユーザー ID
- title (string)：ユーザーの氏名
- email (string)：ユーザーのメールアドレス
- managerId (string)：マネージャー（上司）の ID
- isDisabled (boolean)：ユーザーがアクティブかどうかを示します（false：アクティブ、true：非アクティブ）。
- isDeleted (boolean)：ユーザーアカウントが削除されたかどうかを示します（true：削除済み、false：未削除）。
- createdAt (string)：ユーザーアカウントの作成日時。
- modifiedAt (string)：ユーザーアカウントの最終更新日時。
- profile (object)：部署、都市、国、オフィスなどの基本的なユーザー情報を含むオブジェクト。
- externalReferences (array)：ユーザーアカウントの参照元情報を含む配列です。たとえば、AzureAD（Microsoft Entra のユーザーアカウントなどです。各要素には、ID・名称・メタデータなどの情報が含まれます。
- identity (string)：ユーザーの識別情報

例：正常に処理された場合（ステータスコード 200）、Response body には次のような形式のデータが返されます。


    [
{
  "delegateId": "c34b3379-3170-4462-607b-08de263288eb",
  "teamMemberId": "9e995999-31ee-4476-b15e-35309f369597",
  "isDeleted": false,
  "delegate": {
    "id": "c34b3379-3170-4462-607b-08de263288eb",
    "title": "Tyler Dunn",
    "email": null,
    "managerId": "7853ce01-9a6f-4e07-a3e0-1e3a578655d7",
    "isDisabled": false,
    "isDeleted": false,
    "createdAt": "2025-11-18T08:38:42.94",
    "modifiedAt": "2025-11-18T08:38:42.94",
    "profile": {
      "userId": "c34b3379-3170-4462-607b-08de263288eb",
      "department": null,
      "city": null,
      "country": null,
      "office": null,
      "jobTitle": null,
      "company": null,
      "phone": null,
      "firstName": "Tyler",
      "lastName": "Dunn",
      "hireDateTime": null,
      "createdAt": "2025-11-18T08:38:42.94",
      "modifiedAt": "2025-11-18T08:38:42.94"
    },
    "externalReferences": [
      {
        "userSource": "AzureAD",
        "externalId": "2a5d724b-d11c-494f-9361-8fce5e3b48cb",
        "externalName": "tdunn@compafi464.onmicrosoft.com",
        "metadata": "{\"PrincipalClaimPrefixType\":0}"
      }
    ],
    "identity": null
  },
  "teamMember": {
    "id": "9e995999-31ee-4476-b15e-35309f369597",
    "title": "Robert  Smith",
    "email": "rsmith@compafi464.onmicrosoft.com",
    "managerId": "4cf1a461-a435-4e80-8ac6-a2d4f0a7ef71",
    "isDisabled": false,
    "isDeleted": false,
    "createdAt": "2023-11-06T16:23:29.373",
    "modifiedAt": "2025-11-20T01:00:11.897",
    "profile": {
      "userId": "9e995999-31ee-4476-b15e-35309f369597",
      "department": "Talent Management and Development",
      "city": "Chicago",
      "country": "United States",
      "office": "Chicago",
      "jobTitle": "LMS Administrator",
      "company": null,
      "phone": null,
      "firstName": "Robert",
      "lastName": "Smith",
      "hireDateTime": null,
      "createdAt": "1900-01-01T00:00:00",
      "modifiedAt": "2025-10-30T13:32:04.6"
    },
    "externalReferences": [
      {
        "userSource": "AzureAD",
        "externalId": "1bd885a5-60cb-4756-a50b-1e2af04d98ca",
        "externalName": "rsmith@compafi464.onmicrosoft.com",
        "metadata": "{\"PrincipalClaimPrefixType\":0}"
      }
    ],
    "identity": null
  }
}
]

特定の代理人とそのチームメンバーを取得する

特定の代理人に紐づくチームメンバーの一覧を取得できます。

事前準備

特定の代理人とそのチームメンバーの一覧を取得するには、該当する代理人 ID が必要です。

代理人 ID は、GET /services/users/v2/Delegates リクエストを実行したレスポンスの”delegateId”で取得できます。

手順：