ユーザーとのコンテンツの共有
ユーザーとのコンテンツの共有
コンテンツをユーザーと共有するには、ユーザー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"
}'
ネストされたオブジェクト
コラボレーションの作成時には、リクエスト本文にaccessible_by
とitem
という2つのネストされたオブジェクトを使用します。
accessible_by
オブジェクトは、この項目の共有相手を指定し、グループid
とtype
を含みます。type
フィールドは常にuser
に設定する必要があります。
item
オブジェクトは、共有する項目を指定します。このオブジェクトには、file
として設定する必要があるtype
フィールドと、そのファイルのid
フィールドがあります。