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

taobao.unidesk.rta.assets.material.share (UD素材推送接口)

UD素材推送接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
material_share_top_dto MaterialShareTopDTO 必须 入参
  • └ target_advertiser_ids
  • Number []
  • 必须
  • 1
  • 要推送到的广告主IDs,一次最多50个
  • └ advertiser_id
  • Number
  • 必须
  • 1
  • 广告主ID,素材归属的广告主
  • └ video_ids
  • String []
  • 可选
  • 1
  • 视频IDs,图片和视频必须二选一,一次最多10个
  • └ image_ids
  • String []
  • 可选
  • 1
  • 图片IDs,图片和视频必须二选一,一次最多10个
  • └ type
  • Number
  • 必须
  • 1
  • 文件类型,1:图片,2:视频

响应参数

名称 类型 示例值 描述
result MaterialShareResultTopDTO [] 推送失败的信息
  • └ image_id
  • String
  • 1
  • 推送后新生成的图片ID
  • └ video_id
  • String
  • 1
  • 推送后新生成的视频ID
  • └ fail_reason
  • String
  • 素材已存在
  • 推送失败原因
  • └ type
  • Number
  • 1
  • 文件类型,1:图片,2:视频
  • └ advertiser_id
  • Number
  • 1
  • 广告主ID,素材归属的广告主
  • └ target_advertiser_id
  • Number
  • 1
  • 要推送到的广告主ID
  • └ original_video_id
  • String
  • 1
  • 推送的原视频id
  • └ original_image_id
  • String
  • 1
  • 推送的原图片id
  • └ success
  • Boolean
  • true
  • 推送是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UnideskRtaAssetsMaterialShareRequest req = new UnideskRtaAssetsMaterialShareRequest();
UnideskRtaAssetsMaterialShareRequest.MaterialShareTopDTO obj1 = new UnideskRtaAssetsMaterialShareRequest.MaterialShareTopDTO();
obj1.setTargetAdvertiserIds(new Long[] { 1 };
);
obj1.setAdvertiserId(1L);
obj1.setVideoIds("1");
obj1.setImageIds("1");
obj1.setType(1L);
req.setMaterialShareTopDto(obj1);
UnideskRtaAssetsMaterialShareResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<unidesk_rta_assets_material_share_response>
    <result>
        <material_share_result_top_d_t_o>
            <image_id>1</image_id>
            <video_id>1</video_id>
            <fail_reason>素材已存在</fail_reason>
            <type>1</type>
            <advertiser_id>1</advertiser_id>
            <target_advertiser_id>1</target_advertiser_id>
            <original_video_id>1</original_video_id>
            <original_image_id>1</original_image_id>
            <success>true</success>
        </material_share_result_top_d_t_o>
    </result>
</unidesk_rta_assets_material_share_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

返回
顶部