グループ (詳細)

グループは複数のユーザーを含み、グループを使用するとコラボレーションなどの一部の操作をユーザーの代わりに実行できます。

This resource has a few variations that can be encountered when using the API.

The fields that are part of the full variant can be returned by API endpoints that support the fields parameter. For example, by defining the fields request parameter as id,type when requesting a file by ID, only those fields will be returned in the API response.

string
11446498

このオブジェクトの一意の識別子

string
group

Value is always group

string / date-time
2012-12-12T10:53:43-08:00

グループオブジェクトが作成された日時

Support Group - as imported from Active Directory255

グループについての人間が判読できる説明。

AD:123456

このBoxグループを外部グループにリンクするために外部のグループ同期ツールで使用できる任意の識別子。このフィールドの値には、Active DirectoryオブジェクトIDやGoogleグループIDなどを使用できます。Boxまたは外部システム内でグループ名が更新されたときの問題を回避するために、このフィールドを使用することをお勧めします。

string
managed_group

グループのタイプ。

Value is one of managed_group,all_users_group

admins_only

項目でのコラボレーションにグループを招待できるユーザーを指定します。

admins_onlyに設定すると、会社の管理者、共同管理者、およびグループ管理者がグループを招待できるようになります。

admins_and_membersに設定すると、上記すべての管理者に加えて、グループのメンバーもグループを招待できるようになります。

all_managed_usersに設定すると、社内のすべての管理対象ユーザーがグループを招待できるようになります。

Value is one of admins_only,admins_and_members,all_managed_users

admins_only

グループのメンバーを表示できるユーザーを指定します (グループのメンバーを取得)。

  • admins_only - 企業の管理者、共同管理者、グループのグループ管理者
  • admins_and_members - すべての管理者とグループメンバー
  • all_managed_users - 企業のすべての管理対象ユーザー

Value is one of admins_only,admins_and_members,all_managed_users

string / date-time
2012-12-12T10:53:43-08:00

グループオブジェクトが最後に変更された日時

string
Support

グループの名前

このグループに対して現在のユーザーが持っている権限について説明します。

true

ユーザーが項目でのコラボレーションにグループを招待できるかどうかを指定します。

string
Active Directory255

このグループの元になっている外部ソース(`"Active Directory"、"Google Groups"、"Facebook Groups"など)を追跡します。また、これを設定すると、Box管理者がBoxウェブアプリケーションからグループ名やメンバーを直接編集できなくなります。

Response Example

{
  "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"
}