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

taobao.unidesk.rta.user.advertiser.get (UD广告主查询接口)

UD广告主查询接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
advertiser_top_query_dto AdvertiserTopQueryDTO 可选 查询参数
  • └ page_no
  • Number
  • 可选
  • 1
  • 第几页
  • └ ids
  • Number []
  • 可选
  • 1
  • 广告主ids
  • └ page_size
  • Number
  • 可选
  • 10
  • 每页多少条
  • └ active_period
  • Number
  • 可选
  • 1
  • 活跃账户周期 1:1日内活跃 3: 3日内活跃 7:7日内活跃 15:15 日内活跃 30:30日活跃 -1: 不限活跃度

响应参数

名称 类型 示例值 描述
result AdvertiserTopDTO [] 返回结果,审核拒绝的账户不会返回
  • └ id
  • Number
  • 1
  • 广告主id
  • └ name
  • String
  • 广告主
  • 广告主名称
  • └ media
  • String
  • toutiao
  • 直投媒体
  • └ status
  • Number
  • 1
  • 广告主状态,1:启用,0:停用
  • └ customer_name
  • String
  • 客户名称
  • 客户名称
  • └ master_id
  • Number
  • 1
  • 组织id
  • └ organization_name
  • String
  • 某某组织
  • 组织名称
  • └ optimize_type
  • Number
  • 1
  • 账户转化类型 1 引流 2 深转
total Number 1 总条数

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UnideskRtaUserAdvertiserGetRequest req = new UnideskRtaUserAdvertiserGetRequest();
UnideskRtaUserAdvertiserGetRequest.AdvertiserTopQueryDTO obj1 = new UnideskRtaUserAdvertiserGetRequest.AdvertiserTopQueryDTO();
obj1.setPageNo(1L);
obj1.setIds(new Long[] { 1 };
);
obj1.setPageSize(10L);
obj1.setActivePeriod(1L);
req.setAdvertiserTopQueryDto(obj1);
UnideskRtaUserAdvertiserGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<unidesk_rta_user_advertiser_get_response>
    <result>
        <advertiser_top_d_t_o>
            <id>1</id>
            <name>广告主</name>
            <media>toutiao</media>
            <status>1</status>
            <customer_name>客户名称</customer_name>
            <master_id>1</master_id>
            <organization_name>某某组织</organization_name>
            <optimize_type>1</optimize_type>
        </advertiser_top_d_t_o>
    </result>
    <total>1</total>
</unidesk_rta_user_advertiser_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

返回
顶部