Box Developerドキュメント

ユーザーのグループのリストを取得

get
https://api.box.com/2.0
/users/:user_id/memberships

ユーザーのすべてのグループを取得します。このグループのメンバー、または管理者レベルの権限を持つユーザーのみがこのAPIを使用できます。

リクエスト

bearer [ACCESS_TOKEN]
application/json

パスパラメータ

stringパス内必須
12345

ユーザーのID。

クエリパラメータ

integer (int64)クエリ内省略可能
1000
1000

返す項目の1ページあたりの最大数。

integer (int64)クエリ内省略可能
1000
0

レスポンスが開始される項目のオフセット。

オフセットパラメータ値が10,000を超えているクエリは拒否され、400レスポンスが返されます。

レスポンス

メンバーシップオブジェクトのコレクションを返します。メンバーシップが存在しない場合は、空のコレクションが返されます。

予期しないクライアントエラー。

get
ユーザーのグループのリストを取得
このドキュメント内で一部のAPIを試せるようになりました。
ログイン

リクエストの例

cURL
curl -i -X GET "https://api.box.com/2.0/users/12345/memberships" \
     -H "authorization: Bearer <ACCESS_TOKEN>"
TypeScript Gen
await client.memberships.getUserMemberships(user.id);
Python Gen
client.memberships.get_user_memberships(user.id)
.NET Gen
await client.Memberships.GetUserMembershipsAsync(userId: user.Id);
Java
BoxUser user = new BoxUser(api, id);
Iterable<BoxGroupMembership.Info> memberships = user.getAllMemberships();
for (BoxGroupMembership.Info membershipInfo : memberships) {
    // Do something with the membership.
}
Python
user_memberships = client.user(user_id='33333').get_group_memberships()
for membership in user_memberships:
    print(f'User is in the {membership.group.name} group')
.NET
BoxCollection<BoxGroupMembership> memberships = await client.GroupsManager
    .GetAllGroupMembershipsForUserAsync(userId: "11111");
Node
var userID = '22222';
client.users.getGroupMemberships(userID)
	.then(memberships => {
		/* memberships -> {
			total_count: 1,
			entries: 
			[ { type: 'group_membership',
				id: '12345',
				user: 
					{ type: 'user',
					id: '22222',
					name: 'Alison Wonderland',
					login: 'alice@example.com' },
				group: { type: 'group', id: '11111', name: 'Employees' },
				role: 'member' } ],
			limit: 100,
			offset: 0 }
		*/
	});
iOS
let iterator = client.groups.listMembershipsForUser(userId: "12345")
iterator.next { result in
    switch results {
    case let .success(page):
        for membership in page.entries {
            print("Group Membership with ID \(membership.id) was retrieved")
        }

    case let .failure(error):
        print(error)
    }
}

レスポンスの例

{
  "entries": [
    {
      "id": "11446498",
      "type": "group_membership",
      "user": {
        "id": "11446498",
        "type": "user",
        "name": "Aaron Levie",
        "login": "ceo@example.com"
      },
      "group": {
        "id": "11446498",
        "type": "group",
        "name": "Support",
        "group_type": "managed_group"
      },
      "role": "member",
      "created_at": "2012-12-12T10:53:43-08:00",
      "modified_at": "2012-12-12T10:53:43-08:00"
    }
  ],
  "limit": 1000,
  "offset": 2000,
  "order": [
    {
      "by": "type",
      "direction": "ASC"
    }
  ],
  "total_count": 5000
}