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

taobao.unidesk.rta.assets.material.get (UD素材查询接口)

UD素材查询接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
material_top_query_dto MaterialTopQueryDTO 必须 查询参数
  • └ page_no
  • Number
  • 可选
  • 1
  • 第几页
  • └ ids
  • String []
  • 可选
  • 1
  • 素材ids
  • └ page_size
  • Number
  • 可选
  • 10
  • 每页多少条
  • └ type
  • Number
  • 可选
  • 1
  • 文件类型,1:图片,2:视频
  • └ advertiser_id
  • Number
  • 必须
  • 1
  • 广告主id

响应参数

名称 类型 示例值 描述
result MaterialTopDTO [] 素材信息
  • └ gmt_create
  • Date
  • 1661857199075
  • 创建时间
  • └ 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
  • 图片或视频高度
  • └ signature
  • String
  • 5B1C47DFFDBD3CD
  • 素材签名
  • └ 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
total Number 1 总条数

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UnideskRtaAssetsMaterialGetRequest req = new UnideskRtaAssetsMaterialGetRequest();
UnideskRtaAssetsMaterialGetRequest.MaterialTopQueryDTO obj1 = new UnideskRtaAssetsMaterialGetRequest.MaterialTopQueryDTO();
obj1.setPageNo(1L);
obj1.setIds("1");
obj1.setPageSize(10L);
obj1.setType(1L);
obj1.setAdvertiserId(1L);
req.setMaterialTopQueryDto(obj1);
UnideskRtaAssetsMaterialGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<unidesk_rta_assets_material_get_response>
    <result>
        <material_top_d_t_o>
            <gmt_create>1661857199075</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>
            <signature>5B1C47DFFDBD3CD</signature>
            <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>
        </material_top_d_t_o>
    </result>
    <total>1</total>
</unidesk_rta_assets_material_get_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

返回
顶部