动态文件夹

动态文件夹向云用户提供弹性组织和管理媒体资产高性能和避免破解制作内容风险模式增加新特征和字段,可同时用于云控制台和API

然而,如果使用云化二维功能 DAM和API应用时,从云化二维移位前应了解各种因素固定文件夹模式化

页面描述新方式动态文件夹模式撞击云控制台假设你熟悉云控制台 和API能力 在新选项前可用

动态文件夹模式是什么

动态文件夹模式帮助云用户移动资产资产文件夹重命名文件夹而不影响资产公共标识值交付URL路径

动态文件夹模式还引入概念显示名同媒体库资产文件夹一样,可自由修改而不影响公共标识并交付 URL

反之,当使用云化词时固定文件夹模式下文件夹和资产名显示在媒体库中并发直接反射资产公共标识全路径并控制交付URL路径和文件名内固定文件夹模式中,对文件夹或资产界面中显示的名的修改也会修改资产URL,如果不小心处理,则风险破解制作内容

资产标识符

下表汇总资产动态文件夹模式标识符

标识符	唯一?	可编辑性	描述性
公共身份证	对一号	对	URL交付云状资产时用于识别资产值 可包括语言字符(包括非英文字母)和字符如点等.破折号-)前斜线/) 无法包括空格或任何这些字符?#\% < >+. 公共身份证可以在媒体库或程序化编辑,但如果资产已经在制作中交付,修改公共身份证可破解制作代码 一号公共身份证必须在其产品环境内和特定资产类型中独有性举例说,虽然不推荐使用,但有可能在同一产品环境内拥有相同的图像公共标识和视频
显示名	号	对	云媒体库、云媒体集和云媒体门户中显示的名称也可以程序检索或设置此值 显示名称可带空格和特殊字符,但不能包括前侧斜线/) 同一显示名可能用于不同资产, 即使是在同一资产文件夹中
资产标识	对	号	自动生成不可变资产标识符完全独一无二并允许开发者可靠地编程引用资产,即使其他标识值改变,如果资产移到另一个文件夹等

新建媒体库特征

媒体库偏好顶端有指示器显示您的产品环境可实现动态文件夹:

产品环境动文件夹启动后媒体库有各种新特征

资产文件夹间移动资产

自动态资产文件夹非直接绑定物理存储位置,您可以在毫秒内将资产从一个文件夹移到另一个文件夹。甚至是移动上千件资产或大件资产对移动时间没有影响

移动重命名资产文件夹

移动重命名资产文件夹得到充分支持文件夹右键菜单访问这些选项

资产文件夹名不区分大小写

显示名

• 资产名显示在媒体库预览板顶部和管理资产页面摘要板中反映资产显示名.编辑此值时,该值对资产公有标识(交付 URL)没有作用

• 媒体门户显示资产名和通过公共链路分享的集合网页反映资产显示名并举

公共身份证

完全公有标识值现显示为预览板底部管理资产页面摘要板像上显示用户权限编辑公共标识码时,可使用公共标识码值旁的编辑按钮,使您能够修改公共标识码

面向用户媒体库用户角色编辑公共标识码

• 资产文件夹必须与用户分享可编辑或可管理文件夹权限.
• 标准设置允许媒体库用户编辑公共ID替代搭建允许您使用启动交付URL选项用户权限用户管理控制台设置一页账号管理员

  未看到此选项并想用到产品环境时,联系支持.

上传预置选项

上头上传预置界面重新设计并有新选项

• 新建资产文件夹字段替换文件夹字段显示固定文件夹版本上传预置UI显示值集此字段判定文件夹中资产将在媒体库内显示值集对资产公有标识不产生作用(除非同时选择设置公共标识路径匹配初始资产文件夹路径选项)
• 新建资产命名段添加本节中,您或可:
  • 接受默认资产命名设置
    • 资产公有标识将随机生成独有值,无路径(非公有标识前缀)
    • 资产显示名将自动取自上传文件文件名
  • 定义性自定义命名偏好显示名并公共身份证内含定义URL路径选项公共ID前缀输入使用上传预置有两种选项设置公共ID前缀:
    • 设置公共标识路径匹配初始资产文件夹路径:设置公共ID前缀匹配资产文件夹名称后移到不同文件夹时,公共标识路径不会修改以反映资产新定位
    • 引导路径公有标识:定义定制公共ID前缀.

上传现有显示名

多资产可拥有相同的显示名,即使在同文件夹内也是如此上传一个或多个资产使用已存在显示名时, 则会要求你决定在上传继续前如何继续操作 。

使用上传预置文件文件名使用资产显示名选择选项默认或自定义选项)和文件名中至少一资产上传匹配显示名现有资产或资产

视情你将获得不同的选择

• 上传资产时使用与文件夹中多件现有资产相同的显示名时,会询问下选对象

  • 保留新旧资产同名
  • 输入新资产不同显示名上传

• 上传资产使用同显示名完全正确同一文件夹中现有资产之一, 会询问您想做下列哪位 :

  • 将现有资产替换为上传新资产
    注解

    新建资产替换现有资产时(同存资产文件夹中显示名相同),新资产保留原型公共标识正因如此 公共ID前缀增入资产公有标识 设置公共标识路径匹配初始资产文件夹路径或 引导路径公有标识上传预置设置开机
  • 保留新旧资产同名
  • 输入新资产不同显示名上传

• 多个资产上传时显示名与文件夹中现有资产相同时, 会询问下位中哪一个想做 :

  • 保留新资产和现有资产同显示名
  • 向新资产显示名添加唯一后缀

  将选择行为应用到所有属于此范畴的资产中 或判定每个上传资产命名选项

媒体库搜索

免费文本搜索框通过显示名和公有标识查找资产

新建API选项

带动文件夹的产品环境在云化API中有各种新选项

新上传API

本节描述:

• 新建上传API参数
• 默认上传行为
• 新建上传API响应密钥

新建上传API参数

• 下选参数添加上传API方法 :

  • 资产文件夹文件夹存储资产值不影响资产公有身份证,不敏感案例
  • 显示名媒体库显示资产名称值不影响资产公有标识并不必独有,即使在同文件夹内也是如此可有空格和特殊字符,但不能包括前向斜线/)
  • public_id_prefix字符串预置公共标识带前斜线值可包含字母数值和前向裁剪前缀可用以提供上下文并改进资产文件名交付 URL中SEO,但值不影响资产存储地 Media库
  • use_filename_as_display_name是否自动分配文件名上传资产为资产显示名媒体库唯一相关显示名未传递 。
    
  注解

  if you set use_filename_as_display_name至 真实性上传预设)和原文件名包括前斜线,上传失效时出错显示名不包含斜线

  以上新上传参数还支持所有后端SDKs.

• 上头显示名并资产文件夹并可用之为现有资产设置显式方法论

  参数加进更新adminAPI方法描述下方显示.)

• 下选参数添加到创建/更新上传_预置adminAPI方法

  • use_asset_folder_as_public_id_prefix是否自动应用路径资产文件夹参数(或当资产直接上传到媒体库文件夹时焦点文件夹)作为前缀公共标识值.保证公共标识路径总匹配初始化媒体库资产文件夹并可以帮助保留先前存在的行为固定文件夹模式.只有当相关public_id_prefix或文件夹)没有单独具体说明 。

    获取更多信息文件夹参数见技巧和考量下方显示

• 上头资产文件夹,public_id_prefix,use_filename_as_display_name中并use_asset_folder_as_public_id_prefix参数也可以通过上传_预置adminAPI或上传预置UI方法

默认上传行为

• if显示名既不明文定义,也不通过use_filename_as_display_name选项初始显示名与公有标识相同(或公有标识末段,如果公有标识包含斜线//)

• 上传(或上传预设)不定义资产文件夹参数(或)文件夹参数)资产上传至Media库根文件夹,即使公共ID包含一条斜线路径

  获取更多信息文件夹参数见技巧和考量下方显示

新建上传API响应密钥

API方法上传响应包含资产全细节上传,显式并重命名)现在还包含资产显示名并资产文件夹作为响应的一部分

例举上传图像命名brown-jacket.jpg,并带下列参数:use_filename:true,unique_filename:false,show_name: "时髦棕色夹克,资产文件夹:

返回时间 :

新建管理员API

本节描述:

• 新建管理员API端点
• 新建管理员API选项
• 新建管理员API响应密钥

新建管理员API端点

获取产品环境配置细节

获取细节产品环境配置当前设置包括信息文件夹模式动态或固定式

语法

/配置

可选参数 :

• 设置布林是否将当前配置设置包括在响应中当前返回信息文件夹模式动态或固定式默认:虚伪

币游平台网页版官方通过资产文件夹获取资源

返回直接存储到指定资产文件夹中的所有资产,而不论这些资产公共标识路径方法不返回存储于指定文件夹子文件夹中的资产资产文件夹名不敏感

语法

币游平台网页版官方/resources/by_asset_folder

需求参数 :

• 资产文件夹字符串名资产文件夹

响应相似币游平台网页版官方获取资源方法论

币游平台网页版官方通过资产标识获取资源

返回带指定资产标识的资产这使你能够通过不可变标识获取资产,而不论资源类型、类型、公共标识号、显示名或资产文件夹

语法币游平台网页版官方/resources/by_asset_ids

需求参数 :

• 资产_ids:字符串

响应相似币游平台网页版官方获取资源方法论

通过资产标识取单资源

返回带指定资产标识的资产,包括从此资产衍生出的所有资产的细节这使你能够通过不可变标识获取资产的所有细节,而不论公共标识号、显示名称或资产文件夹

币游平台网页版官方/resources/:asset_id

响应相似通过公共标识获取单资源.

新建管理员API选项

• 更新法币游平台网页版官方端点支持新参数

  • 资产文件夹文件夹存储资产这使您能从一个文件夹移到媒体库中另一个文件夹值不会影响资产公有标识
  • 显示名媒体库内资产名显示值不影响资产公有标识并不必独一化,即使是在同一文件夹内(除非除外)unique_display_name设置为真)可有空格和特殊字符,但不能包括前向斜线/)
  • unique_display_name:如果真实性中传递显示名资产文件夹或指定新资产文件夹面向资产相同显示名已经存在, 随机字符后缀将附加到此资产显示名中, 以确保它独一性资产文件夹.
    默认值 :虚伪.
  注解

  上头 资产文件夹并 显示名参数也可用 上传并 显式上传API方法描述 上方.

• 搜索方法表达式支持显示名字段内

新建管理员API响应密钥

响应币游平台网页版官方/资源并/搜索端点现在包括显示名并资产文件夹.例举 :

新建 webhook通知

• 修改显示名称和资产文件夹(移动资产)例举 :

• 通知有效载荷资产上传显示名并(常量)资产文件夹(如果定义一)

技巧和考量

媒体库技巧和考量

• 文件夹权限

  • 动态文件夹模式文件夹权限继续控制操作 媒体库用户允许执行文件夹内资产(查看资产、下载资产、上传资产或将资产移入文件夹或移出文件夹、删除资产等)。不论资产公有标识路径如何都属实

    举例说,如果资产上传动物类资产文件夹公开标识动物/狗中,用户权限动物类文件夹判定用户对资产能做些什么资产移位宠物类文件夹上权限用户宠物类文件夹继而控制用户能做什么,即使公共ID保留动物/狗.

  • 媒体库用户最小权限级新动态文件夹能力如下:

    • 新建资产文件夹或子文件夹可帮助性
    • 重命名公共标识显示名可编辑性
    • 重命名、移动、删除或分享资产文件夹可管理性

• 压倒现有资产:从媒体库中,您仍然可以以一直可能的方式替换现有资产固定文件夹模式 :

  • 确保媒体库上传预置默认使用使用文件名=真文件文件名使用公共标识上传预置UI后确认资产文件名上传完全匹配资产现有公开标识显示名s))

    使用此方法,您可以使用上传部件或拖放上传(除非公共标识内含斜线)。

  • 指定使用该资产替换的准确公有标识高级选项媒体库上传部件

  上传预设为公共ID生成随机值(这是通过UI创建新上传预设默认设置)时,若向文件名附加随机值,或公用代号包含斜线,上列第二块是唯一可用替换资产的方法

• 默认媒体库上传行为:当您上传资产到媒体库文件夹时(或拖放一组文件夹和子文件夹到媒体库,从而创建新的媒体库文件夹),公共ID不会自动获取匹配路径(公共ID前缀)。

  组织内公共身份证路径匹配媒体库文件夹路径很重要时,可选择设置公共标识路径匹配初始资产文件夹路径上传预置选项用作媒体库上传预设但要记住,即使有这个选项集上传,如果资产后移到媒体库内的另一文件夹中,公共ID值将保留原创值

API技巧和考量

• 公有身份证裁剪:时传递公共标识值包含斜线(例如animals/cats/tiger中传传全值继续公共标识,但斜线不定义资产存储到媒体库路径万一不传递资产文件夹值,资产将显示在媒体库根文件夹中

  如果您想将资产显示在一个媒体库文件夹中匹配公共标识路径内加资产文件夹上传调用同道参数或选传递公共标识值无路径并代之以指定路径资产文件夹参数使用use_asset_folder_as_public_id_prefix:true上传调用或上传预置选项以确保双路径匹配记住,这唯一“同步化”公共标识路径和路径初始化资产文件夹路径选择用户稍后移动资产到另一个资产文件夹时,公共标识路径不会改变以反映资产新媒体库位置

• 文件夹参数 :上头文件夹参数解析上传方法不应再使用后向兼容性会继续得到支持,并等同设置资产文件夹并public_id_prefix(如果这些值未明文传递)动态文件夹产品环境建议更新代码使用资产文件夹和/或public_id_prefix可能时

• 文件夹API:动态文件夹模式文件夹集端点指向媒体库中的资产文件夹而非公共标识确定没有任何代码使用此端点检索文件夹并假设响应中的文件夹路径与公共标识路径相关

• 上传映射:工作时上传映射中,文件夹参数继续同时表示媒体库资产文件夹,当资产为资产时,将在媒体库根级创建懒惰上传交付后, 并第一个段 公共标识 每一项资产以这种方式上传

  与媒体库任何其他资产文件夹一样,通过此进程创建的媒体库文件夹可重命名而不折损上传资产公共标识号,但如果另一个资产懒惰上传到同上传映文件夹中,定义上传父文件夹将重新创建

• 自动创建文件夹:时间动态文件夹模式启动自动创建文件夹中选项上传控制台设置页面忽略代之以:

  • 时设置资产文件夹或文件夹上传调用或上传预置值,媒体库文件夹总能创建
  • 不设置上下文之一,资产总上传媒体库根文件夹公共标识值有斜线和/或public_id_prefix值传递

• 抓取社交媒体资产:取回并社交媒体资产常存媒体库根文件夹无法移动到另一个资产文件夹 。