開発者向け機能:サーバスクリプト:groups.Update
概要¶
サーバスクリプトで指定したグループIDのグループを更新します。
前提条件¶
本機能によるグループの更新にはサイトの管理者権限が必要です。サイトの管理者権限がないユーザで更新したい場合、サイトの管理権限をもったユーザのAPIキーの指定が必要です。
構文¶
パラメータ¶
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| groupId | object | ○ | 対象グループのグループIDを指定 |
| data | string | ○ | 更新内容をJSON形式で指定 |
戻り値¶
指定したグループが更新できた場合には true、更新できなかった場合には false を返却します。
使用例¶
下記の例では、グループ 100 のグループのメンバーをユーザID 5 のユーザ、組織ID 3 の組織で更新します。メンバーがユーザの場合は "User,ユーザID,管理者権限(true/false)"、組織の場合は "Dept,組織ID,管理者権限(true/false)" を指定してください。メンバーの更新は指定したもので全て洗い替えとなります。
JavaScript¶
const apiKey = 'xxxxx...';
const userId = 5;
const deptId = 3;
const groupId = 100;
let groupMembers = [
`User,${userId},true`,
`Dept,${deptId},false`
];
const data = {
ApiKey: apiKey,
GroupMembers: groupMembers
};
groups.Update(groupId, JSON.stringify(data));
