如何使用文档在线编辑功能_网盘与相册服务(PDS)-阿里云帮助中心

本文档描述网盘与相册服务的文档在线编辑功能，您可以通过PDS提供的默认客户端使用文档在线编辑，也可以参考该文档调用API实现文档在线编辑。

文件在线编辑属于增值功能，网盘与相册服务开发版中默认未开启，使用前请先联系我们。

网盘与相册服务开发版，对增值服务会进行单独收费，请见增值服务计费项。

网盘与相册服务开发版，启用在线编辑后，界面功能和企业版一致，界面使用可参考企业版在线编辑功能。

支持格式

表格文件	文字文件	演示文件
et，xls，xlt，xlsx，xlsm，xltx，xltm，csv	doc，docx，txt，dot，wps，wpt，dotx，docm，dotm，rtf	ppt，pptx，pptm，ppsx，ppsm，pps，potx，potm，dpt，dps

说明：

调用方先通过获取在线编辑地址接口，获取在线编辑的URL和token，然后对接、打开在线编辑页面。
在线编辑token具有时效性，需要调用刷新在线编辑token接口，通过office_refresh_token获取新的token。
在线编辑页面对接是通过前端技术实现，推荐直接使用PDS提供的Javascript SDK，来实现文件在线编辑。可以参考Javascript SDK的文件增值服务页面中，getOfficeEditUrl和refreshOfficeEditToken方法的描述，并参考“文档预览方法举例”小节的对接说明。

POST /v2/file/get_office_edit_url

请求参数：

名称	位置	类型	必选	说明
Authorization	header	string		access_token
x-share-token	header	string		分享token，分享下使用，此时不需要传入Authorization
drive_id	body	string	否	drive ID，drive ID和 share ID互斥，必须且只能传一个
share_id	body	string	否	分享ID，分享下使用，此时不能传入drive_id
file_id	body	string	是	需要编辑的文件ID
option	body	json	否	编辑控制选项

option参数

返回参数：

请求示例：

{
	"drive_id": "1",
	"file_id": "xxxxxx",
	"option": {
		"readonly": false,
		"copy": true
	}
}

返回示例：

{
	"edit_url": "xxxxxx",
	"office_access_token": "xxxxxx",
	"office_refresh_token": "xxxxxx"
}

POST /v2/file/refresh_office_edit_token

请求参数：

名称	位置	类型	必选	说明
Authorization	header	string		access_token
x-share-token	header	string		分享token，分享下使用，此时不需要传入Authorization
share_id	body	string	否	分享ID，分享下使用
office_access_token	body	string	是	访问凭证
office_refresh_token	body	string	是	刷新凭证

返回参数：

请求示例：

{
	"office_access_token": "xxxxxx",
	"office_refresh_token": "xxxxxx"
}

返回示例：

{
	"office_access_token": "xxxxxx",
	"office_refresh_token": "xxxxxx"
}

在线编辑页面对接是通过前端技术实现，推荐直接使用PDS提供的Javascript SDK，来实现文件在线编辑。请参考Javascript SDK的文件增值服务页面。

如果不使用PDS Javascript SDK，PDS文档的预览对接的是阿里云IMM的文档预览功能，可以参考IMM快速入门，前端JS-SDK使用部分的描述。其中：获取tokenInfo替换为调用PDS获取在线编辑地址接口；获取refreshToken替换为调用PDS刷新在线编辑token接口。

Web客户端、桌面客户端的文档在线编辑功能，需要对文件有更新权限。

可按照以下步骤排查：

<1> 在线编辑是增值功能，请确认是否开通此功能。

<2> 请确认文档类型，是否为在线编辑支持的类型。

<3> 请确认文档大小，是否超过支持的大小限制，目前是200MB。

<4> 请网盘的超级管理员，在管理控制台-->企业设置-->文件设置界面，查看“上传文件设置”。如果限制上传文档类型的文件，无法对文档进行在线编辑。如果限制了单文件上传的大小，超过限制大小的文档，在线编辑无法保存成功。

使用文档在线编辑功能过程中，遇到问题请联系我们。