カスタム ユーザーグループとは、Learn365 API または Learn365 管理センターを通じて作成、管理できるグループのことです。

Microsoft Entra グループとは異なり、カスタム ユーザーグループには Learn365 ユーザーおよび Flow365 ユーザーの両方を含むことができます。

ここでは、Learn365 API を使用してグループ ID を取得する方法について説明します。

グループ ID を取得する

この操作に必要なロール：LMS 管理者 または カタログ管理者

手順：

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

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

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

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

GET/services/users/v2/Groups Returns the list of active groups

3．必要に応じて、クエリ オプション パラメータを設定し、レスポンス データを絞り込むことができます。

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

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

• ステータスコード 200 が返され、レスポンスにグループ一覧が表示された場合は成功です。
• ユーザーのグループ ID は、id パラメータで確認できます。
• エラーが発生した場合は、レスポンス本文にエラーオブジェクトが含まれます。このオブジェクトには、エラー内容を示す code と message が含まれており、問題の原因を確認できます。