文档预览功能支持 ppt、xls、doc、pdf 等格式文档进行在线预览,便于您进行文档内容管理与访问。

说明 要使用文档预览功能,您需要先开通智能媒体管理 IMM,并在 OSS 中绑定 IMM,详情请参阅智能媒体管理快速开始

参数

操作名称:imm/previewdoc

参数说明如下:

名称 取值 描述
copy 0/1 指定预览文件是否能够复制文档内容。

值为 1,表示支持复制。

值为 0,表示不支持复制。

流程介绍

说明 无论源文件权限是否为公共读,出于安全性考虑此处建议使用 URL 签名方式。
文档预览流程如下:

  1. 客户端向服务端发起预览请求,并提供要预览的文件名。
  2. 服务端根据请求文件进行 URL 签名,将签名完成的 URL 提供给客户端。
  3. 客户端拿到签名后直接访问 OSS 查看文件。

示例

假如请求的 Bucket 为 doc-demo,该 Bucket 所在区域为华东 1,对应的域名为 oss-cn-hangzhou.aliyuncs.com,请求预览的文件为 example.docx。通过配置参数 copy_1 可以复制预览的文档内容。
http://doc-demo.oss-cn-hangzhou.aliyuncs.com/example.docx?x-oss-process=imm/previewdoc,copy_1

对于上面的 URL 采用 AccessKey ID、AccessKey Secret 签名后得到 SignURL 进行访问。



通过 SDK 请求示例:
# 创建存储空间实例,所有文件相关的方法都需要通过存储空间实例来调用。
bucket = oss2.Bucket(oss2.Auth(access_key_id, access_key_secret), endpoint, bucket_name)
# 文档预览,获取signURL。
process = 'imm/previewdoc,copy_1'
params = {}
params.update({bucket.PROCESS: process})
url = bucket.sign_url("GET", objectKey, 3600, params=params)
#打印结果
print url