文档权限
文档权限部分允许更改要编辑和下载的文档的权限。
changeHistory
类型: boolean
允许在使用onRequestRestore事件时显示恢复按钮。默认值为false。
Deprecated
自 5.5 版起已弃用,请改为添加onRequestRestore字段。
示例:true
聊天
类型: boolean
定义是否在文档中启用聊天功能。如果聊天权限设置为true,将显示聊天菜单按钮。
示例:true
评论
类型: boolean
定义是否可以评论文档。如果评论权限设置为"true",文档侧栏将包含评论菜单选项;如果mode参数设置为edit,文档注释将仅对文档编辑器可用。默认值与edit参数的值一致。
备注
如果edit设置为"true"并且comment也设置为"true",用户将能够编辑文档和评论。如果edit设置为"true",comment设置为"false",用户将只能编辑,相应的评论功能将只能查看,评论的添加和编辑将不可用。如果edit设置为"false"并且comment设置为"true",该文档将仅用于评论。如果edit设置为"false",review设置为"false",comments设置为"true",则不考虑fillForms值并且无法填写表单。
示例:true

commentGroups
类型: object
定义用户可以编辑、删除和/或查看其评论[组](../editor/editor.md#user。
[""]值意味着用户可以编辑/删除/查看不属于这些组的人所做的评论(例如,如果文档在第三方编辑器中进行了审阅)。如果值为[],则用户无法编辑/删除/查看任何组的评论。如果edit,remove和view参数为""或未指定,则用户可以查看/编辑/删除任何用户的评论。
示例:
commentGroups.edit
类型: list
用户可以编辑其他用户发表的评论。
示例:["Group2", ""]
commentGroups.remove
类型: list
用户可以删除其他用户的评论。
示例:[]
commentGroups.view
类型: list
用户可以查看其他用户发表的评论。
示例:""
复制
类型: boolean
定义是否可以将内容复制到剪贴板。如果参数设置为false,则粘贴内容将仅在当前文档编辑器中可用。默认值为true。
示例:true
deleteCommentAuthorOnly
类型: boolean
定义用户是否只能删除他/她的评论。默认值为false。
示例:true
下载
类型: boolean
定义文档是可以下载还是只能在线查看或编辑。如果下载权限设置为"false",则文件菜单中将不存在下载为...菜单选项。默认值为true。
示例:true
修改
类型: boolean
定义文档是可以编辑还是只能查看。如果编辑权限设置为"true",文件菜单将包含编辑文档菜单选项;请注意,如果编辑权限设置为"false",文档将在查看器中打开,即使mode参数设置为edit,您也无法将其切换到编辑器。默认值为true。
示例:true
editCommentAuthorOnly
类型: boolean
定义用户是否只能编辑他/她的评论。默认值为false。
示例:true
fillForms
类型: boolean
定义是否可以填写表单。仅当mode参数设置为edit时,文档编辑器和 pdf编辑器才可以填写表单。默认值与edit或review参数的值一致。
备注
如果edit设置为"true"或review设置为"true",则不考虑fillForms值并且可以填写表单。如果edit设置为"false"并且review设置为"false"并且fillForms也设置为"true",用户只能填写文档中的表单。如果edit设置为"false"并且review设置为"false"而且fillForms设置为"true",不考虑comments值并且评论不可用。仅填写表单模式目前仅适用于文档编辑器。
示例:true
modifyContentControl
类型: boolean
定义是否可以更改内容控制设置。 如果mode参数设置为edit,内容控制修改将仅可用于文档编辑器。默认值为true。
示例:true
modifyFilter
类型: boolean
定义过滤器是否可以全局应用(true)影响所有其他用户,或本地应用(false),即仅适用于当前用户。如果mode参数设置为edit,则过滤器修改仅可用于电子表格编辑器。默认值为true。
备注
如果文档由具有完全访问权限的用户编辑,则该用户应用的过滤器将对所有其他用户可见,而不管他们的本地设置如何。
示例:true
类型: boolean
定义是否可以打印文档。如果打印权限设置为"false",则文件菜单中将不存在打印菜单选项。默认值为true。
示例:true
保护
类型: boolean
定义工具栏上的保护选项卡和左侧菜单中的保护按钮是显示 (true) 还是隐藏 (false)。默认值为true。
示例:true
重命名
类型: boolean
允许在使用onRequestRename事件时显示重命名...按钮。默认值为false。
Deprecated
自 6.0 版起已弃用,请改为添加onRequestRename字段。
示例:true
审阅
类型: boolean
定义是否可以查看文档。如果审阅权限设置为true,文档状态栏将包含审阅菜单选项;如果mode参数设置为edit,文档审阅将仅对文档编辑器可用。默认值与edit参数的值一致。
备注
如果edit设置为"true"并且review也设置为"true",用户将能够编辑文档,接受/拒绝所做的更改并切换到他/她自己的审阅模式。如果edit设置为"true"并且review设置为"false",用户将只能进行编辑。如果edit设置为"false"并且review设置为"true",文档将仅在审阅模式下可用。
示例:true

reviewGroups
类型: string数组
定义用户可以接受/拒绝其更改的组。[""]值意味着用户可以查看不属于任何这些组的人所做的更改(例如,如果文档是在第三方编辑器中查看的)。如果值为[],则用户无法查看任何组所做的更改。如果值为""或未指定,则用户可以查看任何用户所做的更改。
示例:["Group1", "Group2", ""]
userInfoGroups
类型: string数组
定义其信息显示在编辑器中的用户组:
- 用户名显示在编辑器标题的编辑用户列表中,
- 输入文本时,会显示用户光标和工具提示及其名称,
- 在严格的共同编辑模式下锁定对象时,会显示用户名。
["Group1", ""]表示显示Group1中的用户和不属于任何组的用户的信息。[]表示根本不显示任何用户信息。undefined或""值表示显示所有用户的信息。
示例:["Group1", ""]
示例
const config = {
document: {
permissions: {
chat: true,
comment: true,
copy: true,
commentGroups: {
edit: ["Group2", ""],
remove: [""],
view: "",
},
deleteCommentAuthorOnly: false,
download: true,
edit: true,
editCommentAuthorOnly: false,
fillForms: true,
modifyContentControl: true,
modifyFilter: true,
print: true,
protect: true,
review: false,
reviewGroups: ["Group1", "Group2", ""],
userInfoGroups: ["Group1", ""],
}
,
},
};
const docEditor = new DocsAPI.DocEditor("placeholder", config);