最新更新:Jan-25-2024
上传预设允许你集中定义一组资产上传选项,而不是在每次上传调用时具体说明这些选项可定义多上传预设并应用不同预设
可设置预设签名或无签名.无签名预设可用无签名上传调用,例如直接从浏览器上传中上传部件或为自动上传设置 。
用例
上传预设使用案例包括:
- 定义资产存储存取方式,例如公共标识值确定方式
使用文件名
)文件夹存储文件夹
和现有资产是否可以替换覆盖覆盖
) - 生成热切文件转换
热切
)这对于视频变换特别有价值 视频变换可能需要较长时间生成 帮助确保上传文件准备交付 - 上传文件时应用进化变换
变换
),例如限制格式类型或文件大小后再存储上传文件 - 应用加载能力,例如自动标签
分类法
或自动适配温和度
上传 - 更新用户生成内容上传行为而不修改网站或移动a
- 搭建默认上传行为通过媒体库或经媒体库上传上传方法命令详解
- 上传首选项使用上传部件.
创建和管理上传预设
可创建、修改或删除上传预设上传预置UI中上传控制台设置或programmatically使用上传_预置
odminAPI方法
- 定义可同时用于图像上传和视频上载的上传预集时,可同时包括图像专用和视频专用上载选项(例如适配或标签加子),只有文件上载预置时才使用相关选项
上传选项中应用不同格式者均静默忽略不过,如果您同时提供进取或热切变换作为上传调用的一部分,确保调用中包含的所有变换参数都与图像和视频相关 - 上传预设或程序化预设也可能影响媒体库上传行为更多信息见管理dAM上传预置.
- if动态文件夹模式激活产品环境,UI和API上传预置有各种附加选项细节见动态文件夹-上传预置选项并动态文件夹-新建上传API参数.
管理使用设置UI上传预置
使用上传预置UI创建或修改上传预置云台并选择设置设置>上传滚动到上传预置段内
上传预置页面包含数节,可设置各种上传选项
创建新上传预设时最重要的考虑是想签名或非签名上传预设举例说,只有签名预设可使用默认上传预置上传API或媒体库或签名上传申请程序反之,大都需使用非签名上传预置件从客户端app使用非签名上传能力或使用上传部件内客户端应用
通常上传预置界面选项并行参数设置上传方法命令不过,有些选项可能只可用programmatically.缺空常指某些子选项或复杂变换选项相关选项热切或输入变换上传预设
资产命名选项和文件夹不同视产品环境使用动态文件夹或固定文件夹模式而定更多信息见命名、存储和文件夹模式选项.
时完成保存上传预设定义、上传预设和设置显示上传控制台设置页面 :
程序化管理上传预置
可使用上传_预置
管理API创建、管理或删除上传预设法, 或通过 RESTAPI调用, 或后端SDKs如果没有服务器端应用程序,可按程序管理上传预置云化CLI.在大多数情况下,您可以应用同组选项上传预置上传方法打个电话
举例说,下列代码创建一个新的非签名上传预置my_预设
请求使用Google标签加载图像和视频引擎自动挂载,删除图像背景并上传到文件夹新产品
:
相似地,您也可以使用管理员API列表、修改或删除现有的上传预设完整细节见上传_预置方法中管理员API引用.
上传预置视频教程
视频引导您跨步使用管理员API创建签名上传预置
教程内容
命名、存储和文件夹模式选项
可能想特别注意下列选项,这些选项会影响资产命名存储方式其中一些选项之间有差异动态固定文件夹模式.
或从中设置设置UI或programmatically使用上传_预置端点管理API查找执行这些选项的具体参数上传方法打个电话
选项 | 动态文件夹模式 | 固定文件夹模式 |
---|---|---|
公共身份证命名偏好 | 默认时公有ID随机生成以确保独一性提高SEO公共标识匹配资产文件名use_filename:true 有或无加随机后缀unique_filename:true/false ) |
选项对固定文件夹模式相同 。 |
目标文件夹和URL路径 | 可指定 use_asset_folder_as_public_id_prefix:true )或可单独指定自定义前缀插入公共标识public_id_prefix )即便这些选项之一设置后,资产后来移动到不同资产文件夹公有身份证路径不变 |
可指定目标文件夹 自动定义URL路径并附公共ID和存储资产文件夹资产后移到不同文件夹时,URL路径相应更新并可能导致交付URL中断制作 |
显示名称 | 上传预置提供选项设置命名优先显示名称,包括使用上传资产文件名use_filename_as_display_name:true 或匹配显示名公共标识的最后段use_filename_as_display_name:false ) |
固定文件夹模式中无显示名 |
上传预置优先级
上传预设使用时,参数上传请求中传递时,下优先级规则在请求中传递时遵循并预设中 :
面向签名上传:带方法请求的参数优先比上传预设参数优先
面向无签名上传方式 :
文件夹
并标签标签
上传预置参数优先级- 其余部分支持上传参数优先上传预设参数(与签名相同)。
默认上传预置
从上传设置中,您也可以单选签名上传预设将分别作为图像、视频和原始文件默认上传预设可选择一组API调用预设和另一组通过媒体库上传默认预设中设置应用到相关资产类型的所有上传中,只要上传调用或媒体库上传部件中未直接指定其他上传预设