文档中心 > API类目 > 阿里妈妈-UniDesk

taobao.unidesk.rta.assets.material.add (UD素材创建接口)

UD素材创建接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
request_id String 可选 1 请求id,用于幂等唯一key 本接口需向媒体侧提交任务耗时较长,因TOPAPI 5秒超时限制,可能会在任务执行中提示“超时”/“远程服务调用超时”/“重复请求”等报错,此时可以用相同的request_id进行幂等重试即可返回最新结果
material_upload_top_dto MaterialUploadTopDTO 必须 素材信息
  • └ type
  • Number
  • 必须
  • 1
  • 文件类型,1:图片,2:视频
  • └ url
  • String
  • 必须
  • http://xxx
  • 素材url
  • └ advertiser_id
  • Number
  • 必须
  • 1
  • 广告主ID
  • └ name
  • String
  • 可选
  • 素材名称
  • 素材名称
  • └ material_upload_type
  • Number
  • 可选
  • 8
  • 素材类型(快手必须),8:开屏视频,7:开屏图片,6:大图竖图,3:大图横图,1002:图片磁贴。7、8还需要传素材宽高
  • └ width
  • Number
  • 可选
  • 1080
  • 素材宽,必传
  • └ height
  • Number
  • 可选
  • 540
  • 素材高,必传

响应参数

名称 类型 示例值 描述
result MaterialTopDTO 素材详细信息
  • └ gmt_create
  • Date
  • 1661760507259
  • 创建时间
  • └ type
  • Number
  • 1
  • 文件类型,1:图片,2:视频
  • └ url
  • String
  • https://ossgw.alicdn.com/creatives-assets/prod/feupload/user/6kutr/e80bcd30-f773-11ec-a587-e15059d17614.jpg
  • 素材url
  • └ advertiser_id
  • Number
  • 1
  • 广告主ID
  • └ duration
  • Number
  • 1
  • 视频时长,单位秒
  • └ size
  • Number
  • 1
  • 文件大小,单位byte
  • └ width
  • Number
  • 720
  • 图片或视频宽度
  • └ name
  • String
  • 素材名称
  • 素材名称
  • └ id
  • String
  • v02033g10000catc8b3c77ua16dov
  • 素材id
  • └ height
  • Number
  • 720
  • 图片或视频高度
  • └ poster
  • String
  • https://ossgw.alicdn.com/creatives-assets/prod/feupload/user/6kutr/ecd30-f773-11ec-a587-e7614.mp4?x-oss-process=video/snapshot,t_0,w_720,h_1280
  • 视频首帧图片url

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UnideskRtaAssetsMaterialAddRequest req = new UnideskRtaAssetsMaterialAddRequest();
req.setRequestId("1");
UnideskRtaAssetsMaterialAddRequest.MaterialUploadTopDTO obj1 = new UnideskRtaAssetsMaterialAddRequest.MaterialUploadTopDTO();
obj1.setType(1L);
obj1.setUrl("http://xxx");
obj1.setAdvertiserId(1L);
obj1.setName("素材名称");
obj1.setMaterialUploadType(8L);
obj1.setWidth(1080L);
obj1.setHeight(540L);
req.setMaterialUploadTopDto(obj1);
UnideskRtaAssetsMaterialAddResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<unidesk_rta_assets_material_add_response>
    <result>
        <gmt_create>1661760507259</gmt_create>
        <type>1</type>
        <url>https://ossgw.alicdn.com/creatives-assets/prod/feupload/user/6kutr/e80bcd30-f773-11ec-a587-e15059d17614.jpg</url>
        <advertiser_id>1</advertiser_id>
        <duration>1</duration>
        <size>1</size>
        <width>720</width>
        <name>素材名称</name>
        <id>v02033g10000catc8b3c77ua16dov</id>
        <height>720</height>
        <poster>https://ossgw.alicdn.com/creatives-assets/prod/feupload/user/6kutr/ecd30-f773-11ec-a587-e7614.mp4?x-oss-process=video/snapshot,t_0,w_720,h_1280</poster>
    </result>
</unidesk_rta_assets_material_add_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部