API によるカスタムユーザーグループへのユーザーの追加または削除

カスタムユーザーグループは、Learn365 API を通じて作成、管理できるグループです。

Microsoft Entraグループとは異なり、カスタムユーザーグループには、Learn365 と Flow365 の両方からあらゆるタイプのユーザーを含むことができます。

ここでは、カスタムユーザーグループにユーザーを追加、またはグループからユーザーを削除する方法を説明します。

事前の準備

カスタムユーザーグループにユーザーを追加、またはグループからユーザーを削除するには、以下のものが必要です。

また、すでにカスタムユーザーグループに属しているユーザーを確認しておくことも重要です。

API経由でこれを行うには

1． https://api.365.systems/ にアクセスし、APIキーで認証します。

2． Groups セクションに移動し、GET /services/users/Groups/{groupId}/members Returns the list of active group members エンドポイントを選択し、右上の「Try it out」を選択します。

3．パラメータを入力します。

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

5．「Execute」を選択してリクエストを実行します。

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

API を通じたカスタムユーザーグループへのユーザーの追加は、以下の手順に沿って行います。

1．https://api.365.systems/ にアクセスし、APIキーで認証します。

2．Groups セクションに移動し、POST /services/users/Groups/{groupId}/members Adds the list of users to the group を選択し、右上の「Try it out」を選択します。

3．パラメータを入力します。

Add custom user group via API-1.png

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

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

カスタムユーザーグループからユーザーを削除する場合、削除するユーザーの数によって使用すエンドポイントが異なります。

API を通じたカスタムユーザーグループへのユーザーの追加は、以下の手順に沿って行います。

1．https://api.365.systems/ にアクセスし、APIキーで認証します。

2．Groups セクションに移動し、

1人のユーザー削除する場合：DELETE /services/users/Groups/{groupId}/members/{userId} Removes the user from the group を選択します。このエンドポイントでは、「groupId」フィールドにユーザーグループ ID を、「userId」フィールドにユーザー ID を入力します。
複数のユーザーを削除する場合：DELETE /services/users/Groups/{groupId}/members Removes the list of users from the group を選択します。このエンドポイントでは、「groupId」フィールドにユーザーグループ ID を入力し、「body」に、グループから削除するユーザーの ID を入力します。

複数のユーザー削除の例

Add custom user group via API-2.png

3．「Execute」を選択してリクエストを実行します。

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