素材概述

素材表示在云文档中需要引用到的资源文件，如文档内图片、附件等。

上传素材指将素材（图片/文件）上传到指定云文档中。素材文件在云空间中不会显示，只会显示在对应云文档中。

上传素材分两大步骤（以文档为例）：

先上传素材

之后添加素材到云文档指定区域，添加到文档请参阅[编辑文档内容]；

上传点类型及对应标识符（token）

上传点类型、描述及对应上传点token示例值如下表所示。

上传点类型	描述	上传点token示例值（请勿直接复制）
`doc_image`	文档图片	doccnFivLCfJfblZjGZtxgabcef
`doc_file`	文档文件	doccnFivLCfJfblZjGZtxgabcef
`docx_image`	新版文档图片	doxcnHI2QLXas8JryTaUggabcef
`docx_file`	新版文档文件	doxcnHI2QLXas8JryTaUggabcef
`sheet_image`	电子表格图片	shtcnb9j0FB9jPxzX5pZqUabcef
`sheet_file`	电子表格文件	shtcnb9j0FB9jPxzX5pZqUabcef
`bitable_image`	多维表格图片	bascni70rJDWTKvGNOmGHmabcef
`bitable_file`	多维表格文件	bascni70rJDWTKvGNOmGHmabcef
`ccm_import_open`	云文档导入文件	无需填写

上传点类型及对应Scope说明

不同上传点，要求的scope不一样，请根据对应上传点申请对应的scope即可

上传点类型	描述
`doc_image`	查看、评论、编辑和管理云文档所有文件查看、评论、编辑和管理文档请参考应用权限
`doc_file`	查看、评论、编辑和管理云文档所有文件查看、评论、编辑和管理文档请参考应用权限
`docx_image`	查看、评论、编辑和管理云文档所有文件查看、评论、编辑和管理文档请参考应用权限
`docx_file`	查看、评论、编辑和管理云文档所有文件查看、评论、编辑和管理文档请参考应用权限
`sheet_image`	查看、评论、编辑和管理云文档所有文件查看、评论、编辑和管理电子表格请参考应用权限
`sheet_file`	查看、评论、编辑和管理云文档所有文件查看、评论、编辑和管理电子表格请参考应用权限
`bitable_image`	查看、评论、编辑和管理云文档所有文件查看、评论、编辑和管理多维表格请参考应用权限
`bitable_file`	查看、评论、编辑和管理云文档所有文件查看、评论、编辑和管理多维表格请参考应用权限
`ccm_import_open`	查看、评论、编辑和管理云文档所有文件请参考应用权限

上传点类型及对应Extra说明

对于某些上传点，素材相关的接口均支持了扩展参数（extra）以适配特殊场景；

ccm_import_open

使用导入接口前，需要上传需要导入的文件，对应的parent_node无需填写，extra填入json序列化后的字符串。

如把本地docx导入云文档doc:

"{ "obj_type": "doc","file_extension": "docx"}"

如把本地xlsx导入云文档sheet:

"{ "obj_type": "sheet","file_extension": "xlsx"}"

bitable_image/bitable_file

拥有高级权限的Bitable，在下载素材或者获取临时下载链接时，需要添加额外的Extra作为URL查询参数鉴权。

type Extra struct {
   BitablePerm struct {
      TableId string `json:"tableId"`
      Attachments map[string]map[string][]string `json:"attachments"`
   } `json:"bitablePerm"`
}

构建Extra参数步骤：

根据附件所在table填写tableId参数，构建Extra对象；

根据附件所在的字段、记录id和文件token，填写attachments参数；其中attachments第一个key为字段id，第二个key为记录id，value为文件token数组；

序列化Extra对象成字符串；

对此字符串进行转义，以便它可以安全地放置在URL查询中。

示例：

{"bitablePerm":{"tableId":"tblO6OeNZxfabcef","attachments":{"fld32zZi5I":{"rec0BuOHq":["boxbcsQNT0JsmrztOnX530abcef"]}}}}
// 转义后
https://open.feishu.cn/open-apis/drive/v1/medias/boxbcsQNT0JsmrztOnX530abcef/download?extra=%7B%22bitablePerm%22%3A%7B%22tableId%22%3A%22tblO6OeNZxfabcef%22%2C%22attachments%22%3A%7B%22fld32zZi5I%22%3A%7B%22rec0BuOHq%22%3A%5B%22boxbcsQNT0JsmrztOnX530abcef%22%5D%7D%7D%7D%7D

上传点类型及对应标识符（token）#

上传点类型及对应Scope说明#

上传点类型及对应Extra说明#

ccm_import_open#

bitable_image/bitable_file#

上传点类型及对应标识符（token）

上传点类型及对应Scope说明

上传点类型及对应Extra说明

ccm_import_open

bitable_image/bitable_file