如何使用文檔線上編輯功能 - Drive and Photo Service

本文檔描述網盤與相簿服務的文檔線上編輯功能，您可以通過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": "testDriveId",
	"file_id": "testFileId",
	"option": {
		"readonly": false,
		"copy": true
	}
}

返回樣本：

{
	"edit_url": "testEditUrl",
	"office_access_token": "testOfficeAccessToken",
	"office_refresh_token": "testOfficeRefreshToken"
}

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": "testOfficeAccessToken",
	"office_refresh_token": "testOfficeRefreshToken"
}

返回樣本：

{
	"office_access_token": "testOfficeAccessToken",
	"office_refresh_token": "testOfficeRefreshToken"
}

線上編輯頁面對接是通過前端技術實現，推薦直接使用PDS提供的Javascript SDK，來實現檔案線上編輯。請參考Javascript SDK的檔案增值服務頁面。

如果不使用PDS Javascript SDK，PDS文檔的預覽對接的是阿里雲IMM的文檔預覽功能，可以參考IMM快速入門，前端JS-SDK使用部分的描述。其中：擷取tokenInfo替換為調用PDS擷取線上編輯地址介面；擷取refreshToken替換為調用PDS重新整理線上編輯token介面。

Web用戶端、案頭用戶端的文檔線上編輯功能，需要對檔案有更新許可權。

可按照以下步驟排查：

<1> 線上編輯是增值功能，請確認是否開通此功能。

<2> 請確認文件類型，是否為線上編輯支援的類型。

<3> 請確認文檔大小，是否超過支援的大小限制，目前是200MB。

<4> 請網盤的超級管理員，在管理主控台-->企業設定-->檔案設定介面，查看“上傳檔案設定”。如果限制上傳文件類型的檔案，無法對文檔進行線上編輯。如果限制了單檔案上傳的大小，超過限制大小的文檔，線上編輯無法儲存成功。

使用文檔線上編輯功能過程中，遇到問題請聯絡我們。