ユーザーとのフォルダの共有
ユーザーとのフォルダの共有
フォルダをユーザーと共有するには、ユーザーIDまたはメールアドレス、フォルダのIDのほか、ユーザーがフォルダにアクセスする際に必要なロールまたは権限を使用してコラボレーションを作成します。コラボレーションロールはeditor
、viewer
、previewer
、uploader
、previewer uploader
、viewer uploader
、co-owner
、またはowner
です。各ロールについての詳しい説明は、Boxのサポートドキュメントを参照してください。
cURL
curl -i -X POST "https://api.box.com/2.0/collaborations" \
-H "Authorization: Bearer <ACCESS_TOKEN>" \
-H "Content-Type: application/json" \
-d '{
"item": {
"type": "file",
"id": "11446498"
},
"accessible_by": {
"type": "user",
"login": "user@example.com"
},
"role": "editor"
}'
.NET
// collaborate folder 11111 with user 22222
BoxCollaborationRequest requestParams = new BoxCollaborationRequest()
{
Item = new BoxRequestEntity()
{
Type = BoxType.Folder,
Id = "11111"
},
Role = "editor",
AccessibleBy = new BoxCollaborationUserRequest()
{
Id = "22222"
}
};
BoxCollaboration collab = await client.CollaborationsManager.AddCollaborationAsync(requestParams);
ネストされたオブジェクト
コラボレーションの作成時には、リクエスト本文にaccessible_by
とitem
という2つのネストされたオブジェクトを使用します。
accessible_by
オブジェクトは、この項目の共有相手を指定し、グループid
とtype
を含みます。type
フィールドは常にuser
に設定する必要があります。
item
オブジェクトは、共有する項目を指定します。このオブジェクトには、folder
として設定する必要があるtype
フィールドと、そのフォルダのid
フィールドがあります。