TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UniversalbpCreativeFindrequireRequest req = new UniversalbpCreativeFindrequireRequest();
UniversalbpCreativeFindrequireRequest.TopServiceContext obj1 = new UniversalbpCreativeFindrequireRequest.TopServiceContext();
obj1.setBizCode("xxxxx");
req.setTopServiceContext(obj1);
UniversalbpCreativeFindrequireRequest.CreativeRequireQueryVo obj2 = new UniversalbpCreativeFindrequireRequest.CreativeRequireQueryVo();
obj2.setCreativeSetMode("professional");
obj2.setCreativeOptimization("professional");
obj2.setMainPicVideo("1");
obj2.setPromotionType("item");
obj2.setSubPromotionType("item");
obj2.setCampaignId(68796878069L);
List<UniversalbpCreativeFindrequireRequest.AdgroupVo> list4 = new ArrayList<UniversalbpCreativeFindrequireRequest.AdgroupVo>();
UniversalbpCreativeFindrequireRequest.AdgroupVo obj5 = new UniversalbpCreativeFindrequireRequest.AdgroupVo();
list4.add(obj5);
obj5.setCampaignId(68796878069L);
obj5.setCampaignName("管家计划_宝贝候选集");
obj5.setAdgroupId(68793666608L);
obj5.setAdgroupName("ds460418344");
obj5.setOnlineStatus(0L);
obj5.setDisplayStatus("pause");
obj5.setAuditStatus(1L);
obj5.setAuditReason("xxxxx");
UniversalbpCreativeFindrequireRequest.AdgroupOcpcVo obj7 = new UniversalbpCreativeFindrequireRequest.AdgroupOcpcVo();
obj7.setEnableOcpc(true);
obj7.setOcpcRatio(200L);
list6.setAdgroupOcpc(obj7);
obj5.setPromotionType("item");
obj5.setSubPromotionType("item");
UniversalbpCreativeFindrequireRequest.CommonMaterialVo obj9 = new UniversalbpCreativeFindrequireRequest.CommonMaterialVo();
obj9.setMaterialId(714616513841L);
obj9.setMaterialType(1L);
obj9.setMaterialName("yiliantest测试请不要拍22");
obj9.setTitle("yiliantest测试请不要拍22");
obj9.setImgUrl("//img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg");
obj9.setLinkUrl("http://item.taobao.com/item.htm?id=715121254343");
obj9.setPrice("999900");
obj9.setBidCount(899900L);
obj9.setQuantity(10L);
obj9.setFirstStartsTime(StringUtils.parseDateTime("2023-04-26 14:51:03"));
obj9.setStarts(StringUtils.parseDateTime("2023-04-26 14:51:03"));
obj9.setCategoryId("16 50010850");
obj9.setPromotionType("item");
obj9.setSubPromotionType("item");
list8.setMaterial(obj9);
obj5.setAliveGroupId(0L);
obj5.setAliveGroupName("宝贝链接(默认)");
obj5.setBlackCreativeStatus("success");
obj2.setAdgroupList(list4);
List<UniversalbpCreativeFindrequireRequest.AdzoneVo> list11 = new ArrayList<UniversalbpCreativeFindrequireRequest.AdzoneVo>();
UniversalbpCreativeFindrequireRequest.AdzoneVo obj12 = new UniversalbpCreativeFindrequireRequest.AdzoneVo();
list11.add(obj12);
obj12.setAdzoneId(111287850198L);
obj12.setAdzoneName("全屏微详情");
obj12.setDescription("首页及购中后的全屏微详情场景");
obj12.setImgUrl("https://img.alicdn.com/imgextra/i2/O1CN01PL50aZ1HTD0KEFMEq_!!6000000000758-2-tps-750-1624.png");
obj2.setAdzoneList(list11);
obj2.setPromotionScene("promotion_scene_crowd");
obj2.setOptimizeTarget("conv");
obj2.setItemSelectedMode("shop");
obj2.setAutoWangWangPicture("1");
req.setCreativeRequireQueryVO(obj2);
UniversalbpCreativeFindrequireResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
UniversalbpCreativeFindrequireRequest req = new UniversalbpCreativeFindrequireRequest();
UniversalbpCreativeFindrequireRequest.TopServiceContextDomain obj1 = new UniversalbpCreativeFindrequireRequest.TopServiceContextDomain();
obj1.BizCode = "xxxxx";
req.TopServiceContext_ = obj1;
UniversalbpCreativeFindrequireRequest.CreativeRequireQueryVoDomain obj2 = new UniversalbpCreativeFindrequireRequest.CreativeRequireQueryVoDomain();
obj2.CreativeSetMode = "professional";
obj2.CreativeOptimization = "professional";
obj2.MainPicVideo = "1";
obj2.PromotionType = "item";
obj2.SubPromotionType = "item";
obj2.CampaignId = 68796878069L;
List<UniversalbpCreativeFindrequireRequest.AdgroupVoDomain> list4 = new List<UniversalbpCreativeFindrequireRequest.AdgroupVoDomain>();
UniversalbpCreativeFindrequireRequest.AdgroupVoDomain obj5 = new UniversalbpCreativeFindrequireRequest.AdgroupVoDomain();
list4.Add(obj5);
obj5.CampaignId = 68796878069L;
obj5.CampaignName = "管家计划_宝贝候选集";
obj5.AdgroupId = 68793666608L;
obj5.AdgroupName = "ds460418344";
obj5.OnlineStatus = 0L;
obj5.DisplayStatus = "pause";
obj5.AuditStatus = 1L;
obj5.AuditReason = "xxxxx";
UniversalbpCreativeFindrequireRequest.AdgroupOcpcVoDomain obj6 = new UniversalbpCreativeFindrequireRequest.AdgroupOcpcVoDomain();
obj6.EnableOcpc = true;
obj6.OcpcRatio = 200L;
obj5.AdgroupOcpc= obj6;
obj5.PromotionType = "item";
obj5.SubPromotionType = "item";
UniversalbpCreativeFindrequireRequest.CommonMaterialVoDomain obj7 = new UniversalbpCreativeFindrequireRequest.CommonMaterialVoDomain();
obj7.MaterialId = 714616513841L;
obj7.MaterialType = 1L;
obj7.MaterialName = "yiliantest测试请不要拍22";
obj7.Title = "yiliantest测试请不要拍22";
obj7.ImgUrl = "//img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg";
obj7.LinkUrl = "http://item.taobao.com/item.htm?id=715121254343";
obj7.Price = "999900";
obj7.BidCount = 899900L;
obj7.Quantity = 10L;
obj7.FirstStartsTime = DateTime.Parse(2023-04-26 14:51:03");
obj7.Starts = DateTime.Parse(2023-04-26 14:51:03");
obj7.CategoryId = "16 50010850";
obj7.PromotionType = "item";
obj7.SubPromotionType = "item";
obj5.Material= obj7;
obj5.AliveGroupId = 0L;
obj5.AliveGroupName = "宝贝链接(默认)";
obj5.BlackCreativeStatus = "success";
obj2.AdgroupList= list4;
List<UniversalbpCreativeFindrequireRequest.AdzoneVoDomain> list9 = new List<UniversalbpCreativeFindrequireRequest.AdzoneVoDomain>();
UniversalbpCreativeFindrequireRequest.AdzoneVoDomain obj10 = new UniversalbpCreativeFindrequireRequest.AdzoneVoDomain();
list9.Add(obj10);
obj10.AdzoneId = 111287850198L;
obj10.AdzoneName = "全屏微详情";
obj10.Description = "首页及购中后的全屏微详情场景";
obj10.ImgUrl = "https://img.alicdn.com/imgextra/i2/O1CN01PL50aZ1HTD0KEFMEq_!!6000000000758-2-tps-750-1624.png";
obj2.AdzoneList= list9;
obj2.PromotionScene = "promotion_scene_crowd";
obj2.OptimizeTarget = "conv";
obj2.ItemSelectedMode = "shop";
obj2.AutoWangWangPicture = "1";
req.CreativeRequireQueryVO_ = obj2;
UniversalbpCreativeFindrequireResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new UniversalbpCreativeFindrequireRequest;
$top_service_context = new TopServiceContext;
$top_service_context->biz_code="xxxxx";
$req->setTopServiceContext(json_encode($top_service_context));
$creative_require_query_v_o = new CreativeRequireQueryVo;
$creative_require_query_v_o->creative_set_mode="professional";
$creative_require_query_v_o->creative_optimization="professional";
$creative_require_query_v_o->main_pic_video="1";
$creative_require_query_v_o->promotion_type="item";
$creative_require_query_v_o->sub_promotion_type="item";
$creative_require_query_v_o->campaign_id="68796878069";
$adgroup_list = new AdgroupVo;
$adgroup_list->campaign_id="68796878069";
$adgroup_list->campaign_name="管家计划_宝贝候选集";
$adgroup_list->adgroup_id="68793666608";
$adgroup_list->adgroup_name="ds460418344";
$adgroup_list->online_status="0";
$adgroup_list->display_status="pause";
$adgroup_list->audit_status="1";
$adgroup_list->audit_reason="xxxxx";
$adgroup_ocpc = new AdgroupOcpcVo;
$adgroup_ocpc->enable_ocpc="true";
$adgroup_ocpc->ocpc_ratio="200";
$adgroup_list->adgroup_ocpc = $adgroup_ocpc;
$adgroup_list->promotion_type="item";
$adgroup_list->sub_promotion_type="item";
$material = new CommonMaterialVo;
$material->material_id="714616513841";
$material->material_type="1";
$material->material_name="yiliantest测试请不要拍22";
$material->title="yiliantest测试请不要拍22";
$material->img_url="//img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg";
$material->link_url="http://item.taobao.com/item.htm?id=715121254343";
$material->price="999900";
$material->bid_count="899900";
$material->quantity="10";
$material->first_starts_time="2023-04-26 14:51:03";
$material->starts="2023-04-26 14:51:03";
$material->category_id="16 50010850";
$material->promotion_type="item";
$material->sub_promotion_type="item";
$adgroup_list->material = $material;
$adgroup_list->alive_group_id="0";
$adgroup_list->alive_group_name="宝贝链接(默认)";
$adgroup_list->black_creative_status="success";
$creative_require_query_v_o->adgroup_list = $adgroup_list;
$adzone_list = new AdzoneVo;
$adzone_list->adzone_id="111287850198";
$adzone_list->adzone_name="全屏微详情";
$adzone_list->description="首页及购中后的全屏微详情场景";
$adzone_list->img_url="https://img.alicdn.com/imgextra/i2/O1CN01PL50aZ1HTD0KEFMEq_!!6000000000758-2-tps-750-1624.png";
$creative_require_query_v_o->adzone_list = $adzone_list;
$creative_require_query_v_o->promotion_scene="promotion_scene_crowd";
$creative_require_query_v_o->optimize_target="conv";
$creative_require_query_v_o->item_selected_mode="shop";
$creative_require_query_v_o->auto_wang_wang_picture="1";
$req->setCreativeRequireQueryVO(json_encode($creative_require_query_v_o));
$resp = $c->execute($req, $sessionKey);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=taobao.universalbp.creative.findrequire' \
-d 'partner_id=apidoc' \
-d 'session=6107362f-9b94-43a5-a85e-39bf4c19af06' \
-d 'sign=317B940F369A4B36BD65FC8C0AF0DE18' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-28+15%3A26%3A52' \
-d 'v=2.0' \
-d 'creative_require_query_v_o=null' \
-d 'top_service_context=null'

# -*- coding: utf-8 -*-
import top.api

req=top.api.UniversalbpCreativeFindrequireRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.top_service_context="数据结构示例JSON格式"
req.creative_require_query_v_o="数据结构示例JSON格式"
try:
	resp= req.getResponse(sessionkey)
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"taobao.universalbp.creative.findrequire");
add_param(pRequest,"top_service_context","数据结构JSON示例");
add_param(pRequest,"creative_require_query_v_o","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,sessionKey);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('taobao.universalbp.creative.findrequire', {
	'top_service_context':'数据结构JSON示例',
	'creative_require_query_v_o':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

<universalbp_creative_findrequire_response>
    <result>
        <info>
            <ok>true</ok>
            <message>参数错误</message>
            <error_code>xxxxx</error_code>
        </info>
        <creative_require_v_o>
            <is_special_category>true</is_special_category>
            <has_mini_detail_video>true</has_mini_detail_video>
            <creative_add_operators>
                <string>[&apos;video&apos;]</string>
            </creative_add_operators>
            <has_item_picture>true</has_item_picture>
            <material_info_list>
                <creative_material_info_vo>
                    <material_id>714616513841</material_id>
                    <is_active_item>false</is_active_item>
                    <is_special_category>false</is_special_category>
                    <has_mini_detail_video>false</has_mini_detail_video>
                    <mini_detail_video_id>398436114008</mini_detail_video_id>
                    <has_item_picture>true</has_item_picture>
                    <has_auto_creative>true</has_auto_creative>
                    <material_image_info_list>
                        <material_image_info_vo>
                            <material_id>714616513841</material_id>
                            <image_position>0</image_position>
                            <img_url>https://img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg</img_url>
                            <link_url>http://item.taobao.com/item.htm?id=668800719012</link_url>
                            <material_name>外投宝贝测试，请不要拍</material_name>
                        </material_image_info_vo>
                    </material_image_info_list>
                </creative_material_info_vo>
            </material_info_list>
            <creative_form_infos>
                <creative_form_info_vo>
                    <type>103</type>
                    <text>513x750</text>
                    <desc_info>竖版模板</desc_info>
                    <creative_add_operators>
                        <string>[&apos;video&apos;]</string>
                    </creative_add_operators>
                    <template_id>202396</template_id>
                    <num_limit>12</num_limit>
                    <current_creative_num>10</current_creative_num>
                    <icon>xxxxx</icon>
                    <content>xxxxx</content>
                </creative_form_info_vo>
            </creative_form_infos>
        </creative_require_v_o>
    </result>
</universalbp_creative_findrequire_response>

{
    "universalbp_creative_findrequire_response":{
        "result":{
            "info":{
                "ok":true,
                "message":"参数错误",
                "error_code":"xxxxx"
            },
            "creative_require_v_o":{
                "is_special_category":true,
                "has_mini_detail_video":true,
                "creative_add_operators":{
                    "string":[
                        "['video']"
                    ]
                },
                "has_item_picture":true,
                "material_info_list":{
                    "creative_material_info_vo":[
                        {
                            "material_id":714616513841,
                            "is_active_item":false,
                            "is_special_category":false,
                            "has_mini_detail_video":false,
                            "mini_detail_video_id":398436114008,
                            "has_item_picture":true,
                            "has_auto_creative":true,
                            "material_image_info_list":{
                                "material_image_info_vo":[
                                    {
                                        "material_id":714616513841,
                                        "image_position":0,
                                        "img_url":"https:\/\/img.alicdn.com\/bao\/uploaded\/i1\/3838159498\/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg",
                                        "link_url":"http:\/\/item.taobao.com\/item.htm?id=668800719012",
                                        "material_name":"外投宝贝测试，请不要拍"
                                    }
                                ]
                            }
                        }
                    ]
                },
                "creative_form_infos":{
                    "creative_form_info_vo":[
                        {
                            "type":"103",
                            "text":"513x750",
                            "desc_info":"竖版模板",
                            "creative_add_operators":{
                                "string":[
                                    "['video']"
                                ]
                            },
                            "template_id":202396,
                            "num_limit":12,
                            "current_creative_num":10,
                            "icon":"xxxxx",
                            "content":"xxxxx"
                        }
                    ]
                }
            }
        }
    }
}

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

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}