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

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

参数

操作名称：imm/previewdoc

参数说明如下：

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

值为 1，表示支持复制。

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

流程介绍

说明 无论源文件权限是否为公共读，出于安全性考虑此处建议使用 URL 签名方式。
文档预览流程如下：
文档预览_智能媒体管理（IMM）_数据处理_对象存储 OSS 阿里云技术文档 第1张
  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 进行访问。


文档预览_智能媒体管理（IMM）_数据处理_对象存储 OSS 阿里云技术文档 第2张
通过 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