特定のグループを更新します。このグループの管理者、または管理者レベルの権限を持つユーザーのみがこのAPIを使用できます。
57645
グループのID。
id,type,name
レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。
このパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。
""Customer Support Group - as imported from Active Directory""
255
グループについての人間が判読できる説明。
"AD:123456"
このBoxグループを外部グループにリンクするために外部のグループ同期ツールで使用できる任意の識別子。
このフィールドの値には、Active DirectoryオブジェクトIDやGoogleグループIDなどを使用できます。
Boxまたは外部システム内でグループ名が更新されたときの問題を回避するために、このフィールドを使用することをお勧めします。
"admins_only"
フォルダでのコラボレーションにグループを招待できるユーザーを指定します。
admins_only
に設定すると、会社の管理者、共同管理者、およびグループ管理者がグループを招待できるようになります。
admins_and_members
に設定すると、上記すべての管理者に加えて、グループの メンバーもグループを招待できるようになります。
all_managed_users
に設定すると、社内のすべての管理対象ユーザーがグループを招待できるようになります。
次の値のいずれか1つ: admins_only
,admins_and_members
,all_managed_users
"admins_only"
グループのメンバーを表示できるユーザーを指定します。
admins_only
- 企業の管理者、共同管理者、グループのグループ管理者admins_and_members
- すべての管理者とグループメンバーall_managed_users
- 企業のすべての管理対象ユーザー次の値のいずれか1つ: admins_only
,admins_and_members
,all_managed_users
"Customer Support"
作成する新しいグループの名前。企業内で一意である必要があります。
"Active Directory"
255
Active Directory
やOkta
など、このグループの元になっている外部ソースを追跡します。
また、これを設定すると、Box管理者がBoxウェブアプリケーションからグループ名やメンバーを直接編集できなくなります。
これはグループを一方向にのみ同期する場合に適しています。
更新されたグループオブジェクトを返します。
競合が原因でグループを作成できないことを示すエラーを返します。
invalid_parameter
: グループ名が企業内で一意でない場合によく返されます。予期しないクライアントエラー。
curl -i -X PUT "https://api.box.com/2.0/groups/57645" \
-H "authorization: Bearer <ACCESS_TOKEN>" \
-H "content-type: application/json" \
-d '{
"name": "Customer Support"
}'
await client.groups.updateGroupById(group.id, {
requestBody: { name: updatedGroupName } satisfies UpdateGroupByIdRequestBody,
} satisfies UpdateGroupByIdOptionalsInput);
client.groups.update_group_by_id(group.id, name=updated_group_name)
await client.Groups.UpdateGroupByIdAsync(groupId: group.Id, requestBody: new UpdateGroupByIdRequestBody() { Name = updatedGroupName });
BoxGroup group = new BoxGroup(api, id);
BoxGroup.Info groupInfo = group.getInfo();
groupInfo.setName("New name for My Group");
group.updateInfo(groupInfo);
group_update = {'name': 'New Group Name'}
updated_group = client.group(group_id='11111').update_info(data=group_update)
print(f'Changed the name of group {updated_group.id} to "{updated_group.name}"')
var updates = new BoxGroupRequest()
{
Name = "New group name"
};
BoxGroup updatedGroup = await client.GroupsManager.UpdateAsync("11111", updates);
client.groups.update('11111', {name: 'New group name'})
.then(group => {
/* group -> {
type: 'group',
id: '11111',
name: 'New group name',
created_at: '2014-09-15T13:15:35-07:00',
modified_at: '2014-09-16T13:15:35-07:00' }
*/
});
client.groups.update(groupId: "11111", name: "Team A", provenance: .value("Test"), externalSyncIdentifier: .value("Test Sync"), description: .value("Test Description"), invitabilityLevel: .allManagedUsers, memberViewabilityLevel: .allManagedUsers) {
(result: Result<Group, BoxSDKError>) in
guard case let .success(group) = result else {
print("Error updating the group")
return
}
print("Group \(group.name) was updated with description: \(group.description)")
}
{
"id": "11446498",
"type": "group",
"created_at": "2012-12-12T10:53:43-08:00",
"description": "Support Group - as imported from Active Directory",
"external_sync_identifier": "AD:123456",
"group_type": "managed_group",
"invitability_level": "admins_only",
"member_viewability_level": "admins_only",
"modified_at": "2012-12-12T10:53:43-08:00",
"name": "Support",
"permissions": {
"can_invite_as_collaborator": true
},
"provenance": "Active Directory"
}