コラボレーションを更新します。
項目の所有者を変更したり、コラボレーションへの招待を承認したりする場合に使用します。
1234
コラボレーションのID
true
招待されたユーザーが招待に関連付けられているフォルダへの親パス全体を見ることができるかどうかを示します。招待されたユーザーには親フォルダ内の権限が付与されないため、自身が参加しているコラボレーションに関係しないコンテンツを閲覧することはできません。
これにより、招待されたユーザーの[すべてのファイル]ページの読み込みに必要な時間が有意に増加することに注意してください。can_view_path
が有効になっているコラボレーションの数を1ユーザーあたり1,000に制限することをお勧めします。
2019-08-29T23:59:00-07:00
コラボレーションの有効期限を設定します。この日付になると、項目から自動的にコラボレーションが削除されます。
editor
付与されるアクセスレベル。
次の値のいずれか1つ: editor
,viewer
,previewer
,uploader
,previewer uploader
,viewer uploader
,co-owner
,owner
accepted
コラボレーション招待のステータスとして、保留中(pending
)、承認、拒否のいずれかを設定します。
次の値のいずれか1つ: pending
,accepted
,rejected
所有者が変わっていない限り、更新されたコラボレーションオブジェクトを返します。
ロールがowner
に変更されるとコラボレーションが削除されて、新しいコラボレーションが作成されます。古いコラボレーションのowner
は、新しいコラボレーションのco-owner
になります。
予期しないクライアントエラー。
curl -X PUT https://api.box.com/2.0/collaborations/1234 \
-H 'Authorization: Bearer <ACCESS_TOKEN>" '
-H 'Content-Type: application/json" '
-d '{
"role": "viewer"
}'
BoxCollaborationRequest requestParams = new BoxCollaborationRequest()
{
Id = "12345",
Role = "viewer"
};
BoxCollaboration collab = await client.CollaborationsManager.EditCollaborationAsync(requestParams);
// Accept all pending collaborations
Collection<BoxCollaboration.Info> pendingCollaborations = BoxCollaboration.getPendingCollaborations(api);
for (BoxCollaboration.Info collabInfo : pendingCollaborations) {
collabInfo.setStatus(BoxCollaboration.Status.ACCEPTED);
collabInfo.getResource().updateInfo(collabInfo);
}
from boxsdk.object.collaboration import CollaborationRole, CollaborationStatus
collaboration = client.collaboration(collab_id='12345')
updated_collaboration = collaboration.update_info(CollaborationRole.EDITOR)
client.collaborations.update('11111', {role: client.collaborationRoles.PREVIEWER})
.then(collaboration => {
/* collaboration -> {
type: 'collaboration',
id: '11111',
created_by:
{ type: 'user',
id: '22222',
name: 'Inviting User',
login: 'inviter@example.com' },
created_at: '2015-11-03T18:36:37-08:00',
modified_at: '2016-11-16T21:01:19-08:00',
expires_at: null,
status: 'accepted',
accessible_by:
{ type: 'user',
id: '33333',
name: 'Collaborated User',
login: 'collaborator@example.com' },
role: 'previewer',
acknowledged_at: '2015-11-03T18:36:37-08:00',
item:
{ type: 'folder',
id: '44444',
sequence_id: '1',
etag: '1',
name: 'Collaborated Folder' } }
*/
});
client.collaborations.update(collaborationId: "12345", role: .viewer) { (result: Result<Collaboration, BoxSDKError>) in
guard case let .success(collaboration) = result else {
print("Error updating collaboration")
return
}
print("Updated collaboration")
}