JD Marketing API

https://opendoc.jd.com/ads_api/jzt
Admin
JD Marketing API is an API that provides Jingzhuntong's advertising capabilities, enabling...
Tokens:568,049
Snippets:2,311
Trust Score:10
Update:4 months ago
Show doc for...
Tokens:
Raw
### Java Request Example

Source: https://opendoc.jd.com/ads_api/jzt/api/word/advertise/dmp/jdTarget/%E8%8E%B7%E5%8F%96sku%E4%BF%A1%E6%81%AF.html

Example of how to call the Get SKU Information API using Java. Ensure you have initialized the JdClient with your credentials and server URL.

```java
public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); 
DmpNewTagInfoSkusRequest request=new DmpNewTagInfoSkusRequest();
 request.setAccessPin("{被免密访问的pin}");
 request.setAuthType("1");
 request.setSkuIds(111111);
 request.setType(0);
 DmpNewTagInfoSkusResponse response=client.execute(request);
```

--------------------------------

### C# Request Example

Source: https://opendoc.jd.com/ads_api/jzt/api/word/advertise/dmp/jdTarget/%E8%8E%B7%E5%8F%96sku%E4%BF%A1%E6%81%AF.html

Example of how to call the Get SKU Information API using C#. Ensure the IJdClient is properly instantiated with your API credentials.

```csharp
IJdClient client = new DefaultJdClient(url, appkey, appsecret);
DmpNewTagInfoSkusRequest req = new DmpNewTagInfoSkusRequest();
 req.accessPin =;
req.authType =;
req.skuIds =;
req.type =;

DmpNewTagInfoSkusResponse response = client.Execute (req, token, DateTime.Now.ToLocalTime());
```

--------------------------------

### PHP Request Example

Source: https://opendoc.jd.com/ads_api/jzt/api/word/advertise/dmp/jdTarget/%E8%8E%B7%E5%8F%96sku%E4%BF%A1%E6%81%AF.html

Example of how to call the Get SKU Information API using PHP. Initialize the JdClient with your application's keys and server URL.

```php
$c = new JdClient();
$c->appKey = appKey;
$c->appSecret = appSecret;
$c->accessToken = accessToken;
$c->serverUrl = SERVER_URL;
$req = new DmpNewTagInfoSkusRequest();
 $req->setAccessPin( ); 
$req->setAuthType( ); 
$req->setSkuIds( ); 
$req->setType( ); 

$resp = $c->execute($req, $c->accessToken);
```

--------------------------------

### Java Request Example

Source: https://opendoc.jd.com/ads_api/jzt/api/word/kuaiche/keyword/getRecommendKeywordByShop.html

Demonstrates how to construct and execute a request to get shop recommended keywords using the JD SDK in Java.

```java
JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); 
AdsDspRtbKeywordShopRecommendListRequest request=new AdsDspRtbKeywordShopRecommendListRequest();
KeywordRecommendVO data=new KeywordRecommendVO();
request.setData(data);
ParamExt system=new ParamExt();
request.setSystem(system);
AdsDspRtbKeywordShopRecommendListResponse response=client.execute(request);
```

--------------------------------

### Java Example for Get Tag List

Source: https://opendoc.jd.com/ads_api/jzt/api/word/advertise/dmp/jdTarget/%E8%8E%B7%E5%8F%96%E6%A0%87%E7%AD%BE%E5%88%97%E8%A1%A8.html

Demonstrates how to initialize the JdClient and create a DmpNewTagListV1Request in Java. Set various parameters for filtering and pagination.

```java
public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); 
DmpNewTagListV1Request request=new DmpNewTagListV1Request();
 request.setAccessPin("{被免密访问的pin}");
 request.setAuthType("1");
 request.setCategoryId("41");
 request.setPageIndex(1);
 request.setPageSize(10);
 request.setTagName("品牌");
 request.setSortType(12);
 request.setIsFavorite(-1);
 request.setLevel(1);
 request.setTagCategoryType(1);
 DmpNewTagListV1Response response=client.execute(request);
```

--------------------------------

### Java Example for Get Media Crowd Details

Source: https://opendoc.jd.com/ads_api/jzt/api/word/advertise/dmp/mediaTarget/%E8%8E%B7%E5%8F%96%E5%AA%92%E4%BD%93%E4%BA%BA%E7%BE%A4%E8%AF%A6%E6%83%85.html

Demonstrates how to initialize the JdClient and execute a DmpCommonZtMediaCrowdGetRequest in Java. Ensure you have the necessary SDKs and credentials.

```java
public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); 
DmpCommonZtMediaCrowdGetRequest request=new DmpCommonZtMediaCrowdGetRequest();
 request.setAccessPin("{被免密访问的pin}");
 request.setAuthType("1");
 request.setMediaCrowdInfo("{}");
 request.setSiteId(0);
 request.setJdMediaUserId(83746292);
 DmpCommonZtMediaCrowdGetResponse response=client.execute(request);
```

--------------------------------

### .NET Example for Get Media Crowd Details

Source: https://opendoc.jd.com/ads_api/jzt/api/word/advertise/dmp/mediaTarget/%E8%8E%B7%E5%8F%96%E5%AA%92%E4%BD%93%E4%BA%BA%E7%BE%A4%E8%AF%A6%E6%83%85.html

Illustrates the usage of the JdClient in .NET for retrieving media crowd details. This example requires proper initialization of the client and request objects.

```csharp
IJdClient client = new DefaultJdClient(url, appkey, appsecret);
DmpCommonZtMediaCrowdGetRequest req = new DmpCommonZtMediaCrowdGetRequest();
 req.accessPin =;
req.authType =;
req.mediaCrowdInfo =;
req.siteId =;
req.jdMediaUserId =;

DmpCommonZtMediaCrowdGetResponse response = client.Execute (req, token, DateTime.Now.ToLocalTime());
```

--------------------------------

### Python Request Example

Source: https://opendoc.jd.com/ads_api/jzt/api/word/kuaiche/ad/list.html

Imports necessary modules, sets default app info, creates an AdsDspRtbKcAdListV2Request, sets data and system, and attempts to get the response.

```python
import jd.api
import json
from jd.api.rest.AdsDspRtbKcAdListV2Request import AdsDspRtbKcAdListV2Request
jd.setDefaultAppInfo(appkey, secret)
a = AdsDspRtbKcAdListV2Request(url,port)
a.data=""
a.system=""

try:
f= a.getResponse(sessionkey)
print(json.dumps(f, ensure_ascii=False))
except Exception,e:
print(e)
```

--------------------------------

### Java Request Example for Get Bid Suggest

Source: https://opendoc.jd.com/ads_api/jzt/api/word/common/getBidSuggest.html

This snippet demonstrates how to construct and execute a request to the Get Bid Suggest API using Java. It initializes the JdClient and the request object, setting necessary parameters.

```java
JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); 
AdsDspRtbAdgroupQueryBidSuggestRequest request=new AdsDspRtbAdgroupQueryBidSuggestRequest();
AutoBiddingVO data=new AutoBiddingVO();
request.setData(data);
ParamExt system=new ParamExt();
request.setSystem(system);
AdsDspRtbAdgroupQueryBidSuggestResponse response=client.execute(request);
```

--------------------------------

### Java Request Example

Source: https://opendoc.jd.com/ads_api/jzt/api/word/advertise/dmp/mediaTarget/%E8%8E%B7%E5%8F%96%E5%AA%92%E4%BD%93%E6%A0%87%E7%AD%BE%E5%88%97%E8%A1%A8.html

Demonstrates how to make a request to the Get Media Tag List API using Java. Ensure you have initialized the JdClient with your credentials and server URL.

```java
public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); 
DmpCommonZtDimensionGetRequest request=new DmpCommonZtDimensionGetRequest();
 request.setAccessPin("{被免密访问的pin}");
 request.setAuthType("1");
 request.setMediaResourceType(1);
 request.setProfileType(1);
 request.setSiteId(0);
 request.setJdMediaUserId(93879573);
 DmpCommonZtDimensionGetResponse response=client.execute(request);
```

--------------------------------

### .NET Request Example

Source: https://opendoc.jd.com/ads_api/jzt/api/word/advertise/dmp/mediaTarget/%E8%8E%B7%E5%8F%96%E5%AA%92%E4%BD%93%E6%A0%87%E7%AD%BE%E5%88%97%E8%A1%A8.html

Illustrates how to use the Get Media Tag List API with .NET. Initialize the IJdClient with the correct URL, app key, and app secret.

```csharp
IJdClient client = new DefaultJdClient(url, appkey, appsecret);
DmpCommonZtDimensionGetRequest req = new DmpCommonZtDimensionGetRequest();
 req.accessPin = "abc";
req.authType = "abc";
req.mediaResourceType = 123;
req.profileType = 123;
req.siteId = 123;
req.jdMediaUserId = 123L;

DmpCommonZtDimensionGetResponse response = client.Execute (req, token, DateTime.Now.ToLocalTime());
```

--------------------------------

### Java Request Example

Source: https://opendoc.jd.com/ads_api/jzt/api/word/kuaiche/adgroup/shoprecommand.html

Demonstrates how to construct and execute a request to query recommended shop lists using the Java SDK. Ensure you have initialized the JdClient with your credentials and server URL.

```java
JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); 
AdsDspRtbadFacedMaterialqueryQueryRecommendShopListRequest request=new AdsDspRtbadFacedMaterialqueryQueryRecommendShopListRequest();
DeliveryRecommendShopQueryCommand data=new DeliveryRecommendShopQueryCommand();
request.setData(data);
ParamExt system=new ParamExt();
request.setSystem(system);
AdsDspRtbadFacedMaterialqueryQueryRecommendShopListResponse response=client.execute(request);
```

--------------------------------

### PHP Request Example

Source: https://opendoc.jd.com/ads_api/jzt/api/word/zhanwai/ad/querySpec.html

Example of how to construct and execute a request to get supported creative specifications using the JdClient in PHP.

```php
$c = new JdClient();
$c->appKey = appKey;
$c->appSecret = appSecret;
$c->accessToken = accessToken;
$c->serverUrl = SERVER_URL;
$req = new AdsDspRtbadFacedAdDeliverySpecListRequest();
$data= new Data;
$req->setData($data);
$system= new System;
$req->setSystem($system);

$resp = $c->execute($req, $c->accessToken);
```

--------------------------------

### Java Request Example

Source: https://opendoc.jd.com/ads_api/jzt/api/word/zhanwai/ad/querySpec.html

Example of how to construct and execute a request to get supported creative specifications using the JdClient in Java.

```java
JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); 
AdsDspRtbadFacedAdDeliverySpecListRequest request=new AdsDspRtbadFacedAdDeliverySpecListRequest();
DeliverySpecQuery data=new DeliverySpecQuery();
request.setData(data);
ParamExt system=new ParamExt();
request.setSystem(system);
AdsDspRtbadFacedAdDeliverySpecListResponse response=client.execute(request);
```

--------------------------------

### Java Request Example

Source: https://opendoc.jd.com/ads_api/jzt/api/word/recommend/adgroup/updateDmpCoef.html

Demonstrates how to instantiate the client, create a request object, set parameters, and execute the API call in Java. Ensure you have the necessary SDKs and credentials configured.

```java
public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); 
AdsDspRtbTpBatchUpdateDmpPriceRequest request=new AdsDspRtbTpBatchUpdateDmpPriceRequest();
 request.setAdGroupId(222);
 request.setAdGroupPrice(12);
 request.setIds(1111,12);
 request.setAccessPin("accessPin");
 request.setAuthType("0");
 request.setPlatformBusinessType("DST_JZT");
 AdsDspRtbTpBatchUpdateDmpPriceResponse response=client.execute(request);
```

--------------------------------

### Python Request Example

Source: https://opendoc.jd.com/ads_api/jzt/api/word/kuaiche/adgroup/shoprecommand.html

Illustrates how to use the Python SDK to query recommended shop lists. Remember to set default app information and handle potential exceptions during the request.

```python
import jd.api
import json
from jd.api.rest.AdsDspRtbadFacedMaterialqueryQueryRecommendShopListRequest import AdsDspRtbadFacedMaterialqueryQueryRecommendShopListRequest
jd.setDefaultAppInfo(appkey, secret)
a = AdsDspRtbadFacedMaterialqueryQueryRecommendShopListRequest(url,port)
a.data=""
a.system=""

try:
f= a.getResponse(sessionkey)
print(json.dumps(f, ensure_ascii=False))
except Exception,e:
print(e)


```

--------------------------------

### Python Request Example

Source: https://opendoc.jd.com/ads_api/jzt/api/word/zhanwai/ad/querySpec.html

Example of how to construct and execute a request to get supported creative specifications using the jd.api library in Python.

```python
import jd.api
import json
from jd.api.rest.AdsDspRtbadFacedAdDeliverySpecListRequest import AdsDspRtbadFacedAdDeliverySpecListRequest
jd.setDefaultAppInfo(appkey, secret)
a = AdsDspRtbadFacedAdDeliverySpecListRequest(url,port)
a.data=""
a.system=""

try:
f= a.getResponse(sessionkey)
print(json.dumps(f, ensure_ascii=False))
except Exception,e:
print(e)
```

--------------------------------

### XML Response Example

Source: https://opendoc.jd.com/ads_api/jzt/api/word/advertise/dmp/jdTarget/%E8%8E%B7%E5%8F%96sku%E4%BF%A1%E6%81%AF.html

Example of a successful XML response from the Get SKU Information API, illustrating the data structure for SKU details and system parameters.

```xml
<?xml version="1.0" encoding="UTF-8"?>
<object>
  <jingdong_dmp_new_tag_info_skus_responce>
    <data>
      <code>1</code>
      <data>
        <validSkuList>
          <element>
            <checked>1</checked>
            <id>32434</id>
            <name>XXX冰箱</name>
          </element>
        </validSkuList>
      </data>
      <msg>错误时将返回具体信息</msg>
      <success>true</success>
      <system>
        <businessFrom>JOS</businessFrom>
        <loginPin>login_pin</loginPin>
        <loginType>product</loginType>
        <requestFrom>PC</requestFrom>
        <requestIp>127.0.0.1</requestIp>
        <requestURI>/dmp/new/tag/info/skus</requestURI>
        <siteId>17</siteId>
        <traceId>2cb155af9ec7beac1e9e4ab7e1cffe1c</traceId>
      </system>
    </data>
  </jingdong_dmp_new_tag_info_skus_responce>
</object>
```

--------------------------------

### Java Example for Normal Brand List

Source: https://opendoc.jd.com/ads_api/jzt/api/word/haitou/normalBrandList.html

Demonstrates how to initialize the JdClient and make a request to the Normal Brand List API in Java.

```java
JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); 
AdsIbgHaitouJosServiceNormalBrandListRequest request=new AdsIbgHaitouJosServiceNormalBrandListRequest();
NormalReportRequest normalReportRequest=new NormalReportRequest();
request.setNormalReportRequest(normalReportRequest);
OpenApiSysDto openApiSysDto=new OpenApiSysDto();
request.setOpenApiSysDto(openApiSysDto);
AdsIbgHaitouJosServiceNormalBrandListResponse response=client.execute(request);
```

--------------------------------

### JSON Response Example

Source: https://opendoc.jd.com/ads_api/jzt/api/word/advertise/dmp/jdTarget/%E8%8E%B7%E5%8F%96sku%E4%BF%A1%E6%81%AF.html

Example of a successful JSON response from the Get SKU Information API, detailing the structure of returned SKU data and system information.

```json
{
  "jingdong_dmp_new_tag_info_skus_responce": {
    "data": {
      "msg": "错误时将返回具体信息",
      "code": "1",
      "system": {
        "traceId": "2cb155af9ec7beac1e9e4ab7e1cffe1c",
        "loginType": "product",
        "siteId": "17",
        "businessFrom": "JOS",
        "requestIp": "127.0.0.1",
        "requestURI": "/dmp/new/tag/info/skus",
        "loginPin": "login_pin",
        "requestFrom": "PC"
      },
      "data": {
        "validSkuList": [
          {
            "name": "XXX冰箱",
            "checked": "1",
            "id": "32434"
          }
        ]
      },
      "success": "true"
    }
  }
}
```

--------------------------------

### Python Request Example

Source: https://opendoc.jd.com/ads_api/jzt/api/word/advertise/dmp/jdTarget/%E8%8E%B7%E5%8F%96sku%E4%BF%A1%E6%81%AF.html

Example of how to call the Get SKU Information API using Python. This snippet demonstrates setting request parameters and handling the response.

```python
import jd.api
import json
from jd.api.rest.DmpNewTagInfoSkusRequest import DmpNewTagInfoSkusRequest
jd.setDefaultAppInfo(appkey, secret)
a = DmpNewTagInfoSkusRequest(url,port)
 a.accessPin = 
 a.authType = 
 a.skuIds = 
 a.type = 
 
try:
f= a.getResponse(sessionkey)
print(json.dumps(f, ensure_ascii=False))
except Exception,e:
print(e)
```

--------------------------------

### PHP Request Example

Source: https://opendoc.jd.com/ads_api/jzt/api/word/query/keywordList.html

Example of how to construct and execute a keyword list query request using the PHP SDK.

```php
$c = new JdClient();
$c->appKey = appKey;
$c->appSecret = appSecret;
$c->accessToken = accessToken;
$c->serverUrl = SERVER_URL;
$req = new AdsDspRtbadFacedMaterialqueryQueryKeywordPageByParamRequest();
$data= new Data;
$req->setData($data);
$system= new System;
$req->setSystem($system);

$resp = $c->execute($req, $c->accessToken);
```

--------------------------------

### Java Request Example

Source: https://opendoc.jd.com/ads_api/jzt/api/word/query/keywordList.html

Example of how to construct and execute a keyword list query request using the Java SDK.

```java
JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); 
AdsDspRtbadFacedMaterialqueryQueryKeywordPageByParamRequest request=new AdsDspRtbadFacedMaterialqueryQueryKeywordPageByParamRequest();
KeywordInfoQuery data=new KeywordInfoQuery();
request.setData(data);
ParamExt system=new ParamExt();
request.setSystem(system);
AdsDspRtbadFacedMaterialqueryQueryKeywordPageByParamResponse response=client.execute(request);
```

--------------------------------

### XML Response Example for Get Bid Suggest

Source: https://opendoc.jd.com/ads_api/jzt/api/word/common/getBidSuggest.html

This is a sample XML response from the Get Bid Suggest API, illustrating the data structure for a successful bid suggestion request.

```xml
<?xml version="1.0" encoding="UTF-8"?>
<object>
  <jingdong_ads_dsp_rtb_adgroup_queryBidSuggest_responce>
    <data>
      <code>1</code>
      <data>
        <recommendCeilingBid>11</recommendCeilingBid>
        <recommendFloorBid>1</recommendFloorBid>
        <recommend_bid>8.0</recommend_bid>
        <recommend_reserve_bid>86</recommend_reserve_bid>
        <sid>234232</sid>
        <top_price_troi>2.0</top_price_troi>
      </data>
      <msg>成功</msg>
      <success>true</success>
      <system>
        <appKey>34534ap345pK345ey</appKey>
        <pin>test123</pin>
        <requestFrom>jos</requestFrom>
        <traceId>werwe34er53413sd</traceId>
        <venderId>34059834</venderId>
      </system>
    </data>
  </jingdong_ads_dsp_rtb_adgroup_queryBidSuggest_responce>
</object>
```

--------------------------------

### Python Request Example

Source: https://opendoc.jd.com/ads_api/jzt/api/word/kuaiche/keyword/getRecommendKeywordByShop.html

Illustrates how to fetch shop recommended keywords using the JD SDK in Python. Includes basic error handling.

```python
import jd.api
import json
from jd.api.rest.AdsDspRtbKeywordShopRecommendListRequest import AdsDspRtbKeywordShopRecommendListRequest
jd.setDefaultAppInfo(appkey, secret)
a = AdsDspRtbKeywordShopRecommendListRequest(url,port)
a.data=""
a.system=""

try:
f= a.getResponse(sessionkey)
print(json.dumps(f, ensure_ascii=False))
except Exception,e:
print(e)


```

--------------------------------

### XML Response Example for Get Bound Unit List

Source: https://opendoc.jd.com/ads_api/jzt/api/word/advertise/dmp/mediaTarget/%E8%8E%B7%E5%8F%96%E4%BA%BA%E7%BE%A4%E5%B7%B2%E7%BB%91%E5%AE%9A%E7%9A%84%E5%8D%95%E5%85%83%E5%88%97%E8%A1%A8.html

Example of a successful XML response when retrieving a list of bound units. This format provides the same data as the JSON response.

```xml
<?xml version="1.0" encoding="UTF-8"?>
<object>
  <jingdong_dmp_new_crowd_group_refjson_responce>
    <data>
      <code>1</code>
      <data>
        <element>
          <businessType>256</businessType>
          <campaignType>12</campaignType>
          <planId>283764582</planId>
          <planName>计划名称</planName>
          <statusLabel>状态中文</statusLabel>
          <unitId>837465923</unitId>
          <unitName>单元名称</unitName>
          <unitStatus>单元状态 标识出 单元是否已经删除</unitStatus>
        </element>
      </data>
      <msg>错误时将返回具体信息</msg>
      <success>true</success>
      <systemVo>
        <traceId>2cb155af9ec7beac1e9e4ab7e1cffe1c</traceId>
      </systemVo>
    </data>
  </jingdong_dmp_new_crowd_group_refjson_responce>
</object>
```

--------------------------------

### PHP Request Example

Source: https://opendoc.jd.com/ads_api/jzt/api/word/swa/add.html

Shows how to initiate a batch SwaCampaign creation request using the JdClient in PHP. This example requires setting up the client with your credentials and request object.

```php
$c = new JdClient();
$c->appKey = appKey;
$c->appSecret = appSecret;
$c->accessToken = accessToken;
$c->serverUrl = SERVER_URL;
$req = new AdsDspRtbadFacedCampaignBatchCreateSwaCampaignRequest();
$data= new Data;
$req->setData($data);
$system= new System; 
$req->setSystem($system);

$resp = $c->execute($req, $c->accessToken);

```

--------------------------------

### Java Request Example

Source: https://opendoc.jd.com/ads_api/jzt/api/word/kuaiche/keyword/getHistory.html

Demonstrates how to initialize the JdClient and create a request for finding historical keywords in Java. Ensure you have the necessary SDKs and credentials.

```java
public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); 
AdsDspRtbKeywordFindKeyWordHistoryRequest request=new AdsDspRtbKeywordFindKeyWordHistoryRequest();
 request.setAccessPin("pin");
 request.setAuthType("0");
 request.setPlatformBusinessType("DST_JZT");
 AdsDspRtbKeywordFindKeyWordHistoryResponse response=client.execute(request);
```

--------------------------------

### JSON Response Example for Get Bound Unit List

Source: https://opendoc.jd.com/ads_api/jzt/api/word/advertise/dmp/mediaTarget/%E8%8E%B7%E5%8F%96%E4%BA%BA%E7%BE%A4%E5%B7%B2%E7%BB%91%E5%AE%9A%E7%9A%84%E5%8D%95%E5%85%83%E5%88%97%E8%A1%A8.html

Example of a successful JSON response when retrieving a list of bound units. It includes details about the crowd, plans, and units.

```json
{
  "jingdong_dmp_new_crowd_group_refjson_responce": {
    "data": {
      "msg": "错误时将返回具体信息",
      "systemVo": {
        "traceId": "2cb155af9ec7beac1e9e4ab7e1cffe1c"
      },
      "code": "1",
      "data": [
        {
          "campaignType": "12",
          "unitName": "单元名称",
          "planName": "计划名称",
          "unitId": "837465923",
          "planId": "283764582",
          "businessType": "256",
          "statusLabel": "状态中文",
          "unitStatus": "单元状态 标识出 单元是否已经删除"
        }
      ],
      "success": "true"
    }
  }
}
```

--------------------------------

### Java Request Example

Source: https://opendoc.jd.com/ads_api/jzt/api/word/swa/add.html

Demonstrates how to create a batch of SwaCampaigns using the JdClient in Java. Ensure you have the necessary client and request objects initialized.

```java
JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); 
AdsDspRtbadFacedCampaignBatchCreateSwaCampaignRequest request=new AdsDspRtbadFacedCampaignBatchCreateSwaCampaignRequest();
SwaCampaignBatchCreateCommand data=new SwaCampaignBatchCreateCommand();
request.setData(data);
ParamExt system=new ParamExt();
request.setSystem(system);
AdsDspRtbadFacedCampaignBatchCreateSwaCampaignResponse response=client.execute(request);
```

--------------------------------

### JSON Response Example for Get Bid Suggest

Source: https://opendoc.jd.com/ads_api/jzt/api/word/common/getBidSuggest.html

This is a sample JSON response from the Get Bid Suggest API, showing the structure of a successful response including bid recommendations and system information.

```json
{
  "jingdong_ads_dsp_rtb_adgroup_queryBidSuggest_responce": {
    "data": {
      "msg": "成功",
      "code": "1",
      "system": {
        "traceId": "werwe34er53413sd",
        "pin": "test123",
        "venderId": "34059834",
        "appKey": "34534ap345pK345ey",
        "requestFrom": "jos"
      },
      "data": {
        "recommend_reserve_bid": "86",
        "top_price_troi": "2.0",
        "recommendFloorBid": "1",
        "recommendCeilingBid": "11",
        "recommend_bid": "8.0",
        "sid": "234232"
      },
      "success": "true"
    }
  }
}
```

--------------------------------

### Get Ad Group Response Example

Source: https://opendoc.jd.com/ads_api/jzt/api/word/zhanwai/adgroup/get.html

This example demonstrates the structure of a successful response when retrieving ad group details. It includes campaign information, bidding settings, targeting parameters, and status.

```APIDOC
## GET /api/word/zhanwai/adgroup/get

### Description
Retrieves the details of a specific ad group.

### Method
GET

### Endpoint
/api/word/zhanwai/adgroup/get

### Response
#### Success Response (200)
- **data** (object) - The main response object.
  - **msg** (string) - Success message.
  - **traceId** (string) - Unique identifier for tracing the request.
  - **code** (string) - Response code, '1' indicates success.
  - **data** (object) - Ad group details.
    - **campaignType** (string) - Type of the campaign.
    - **biddingControlType** (string) - Type of bidding control.
    - **promotedTargetType** (string) - Type of promoted target.
    - **campaignId** (string) - ID of the associated campaign.
    - **fee** (string) - Fee associated with the ad group.
    - **remark** (string) - Remarks or notes for the ad group.
    - **areaIds** (array) - List of area IDs where the ad group is targeted.
    - **detailedPageType** (string) - Type of the detailed page.
    - **deliveryTarget** (string) - Delivery target for the ad group.
    - **adGroupId** (string) - Unique identifier for the ad group.
    - **trafficStrategyList** (array) - List of traffic strategies.
      - **sceneId** (string) - ID of the scene.
      - **strategyModel** (string) - Model of the strategy.
      - **strategyId** (string) - ID of the strategy.
    - **promotedObject** (string) - The promoted object.
    - **name** (string) - Name of the ad group.
    - **crowdInfos** (array) - Information about crowds.
      - **crowdId** (string) - ID of the crowd.
      - **isUsed** (string) - Indicates if the crowd is used.
    - **skuId** (string) - ID of the SKU.
    - **status** (string) - Status of the ad group.
  - **success** (string) - Indicates if the operation was successful ('true' or 'false').

#### Response Example (JSON)
```json
{
  "jingdong_ads_dsp_rtbad_faced_adgroup_getAdGroup_responce": {
    "data": {
      "msg": "成功",
      "traceId": "12312312sdw",
      "code": "1",
      "data": {
        "campaignType": "8",
        "biddingControlType": "5",
        "promotedTargetType": "1",
        "campaignId": "12312",
        "fee": "12",
        "remark": "备注信息",
        "areaIds": [
          "0"
        ],
        "detailedPageType": "2345678",
        "deliveryTarget": "23",
        "adGroupId": "1241241",
        "trafficStrategyList": [
          {
            "sceneId": "64",
            "strategyModel": "1",
            "strategyId": "20001"
          }
        ],
        "promotedObject": "12345678",
        "name": "手机类目单元",
        "crowdInfos": [
          {
            "crowdId": "762391",
            "isUsed": "1"
          }
        ],
        "skuId": "12345678",
        "status": "2"
      },
      "success": "true"
    }
  }
}
```

#### Response Example (XML)
```xml
<?xml version="1.0" encoding="UTF-8"?>
<object>
  <jingdong_ads_dsp_rtbad_faced_adgroup_getAdGroup_responce>
    <data>
      <code>1</code>
      <data>
        <adGroupId>1241241</adGroupId>
        <areaIds>
          <element>0</element>
        </areaIds>
        <biddingControlType>5</biddingControlType>
        <campaignId>12312</campaignId>
        <campaignType>8</campaignType>
        <crowdInfos>
          <element>
            <crowdId>762391</crowdId>
            <isUsed>1</isUsed>
          </element>
        </crowdInfos>
        <deliveryTarget>23</deliveryTarget>
        <detailedPageType>2345678</detailedPageType>
        <fee>12</fee>
        <name>手机类目单元</name>
        <promotedObject>12345678</promotedObject>
        <promotedTargetType>1</promotedTargetType>
        <remark>备注信息</remark>
        <skuId>12345678</skuId>
        <status>2</status>
        <trafficStrategyList>
          <element>
            <sceneId>64</sceneId>
            <strategyId>20001</strategyId>
            <strategyModel>1</strategyModel>
          </element>
        </trafficStrategyList>
      </data>
      <msg>成功</msg>
      <success>true</success>
      <traceId>12312312sdw</traceId>
    </data>
  </jingdong_ads_dsp_rtbad_faced_adgroup_getAdGroup_responce>
</object>
```
```

--------------------------------

### Python Request Example

Source: https://opendoc.jd.com/ads_api/jzt/api/word/advertise/dmp/mediaTarget/%E8%8E%B7%E5%8F%96%E5%AA%92%E4%BD%93%E6%A0%87%E7%AD%BE%E5%88%97%E8%A1%A8.html

Provides a Python example for calling the Get Media Tag List API. Remember to set default app information and handle potential exceptions during the API call.

```python
import jd.api
import json
from jd.api.rest.DmpCommonZtDimensionGetRequest import DmpCommonZtDimensionGetRequest
jd.setDefaultAppInfo(appkey, secret)
a = DmpCommonZtDimensionGetRequest(url,port)
 a.accessPin = "abc" 
 a.authType = "abc" 
 a.mediaResourceType = 123 
 a.profileType = 123 
 a.siteId = 123 
 a.jdMediaUserId = 123L 
 
try:
f= a.getResponse(sessionkey)
print(json.dumps(f, ensure_ascii=False))
except Exception,e:
print(e)
```

--------------------------------

### PHP Example for Normal Brand List

Source: https://opendoc.jd.com/ads_api/jzt/api/word/haitou/normalBrandList.html

Shows how to set up the JdClient and send a request to the Normal Brand List API using PHP.

```php
$c = new JdClient();
$c->appKey = appKey;
$c->appSecret = appSecret;
$c->accessToken = accessToken;
$c->serverUrl = SERVER_URL;
$req = new AdsIbgHaitouJosServiceNormalBrandListRequest();
$normalReportRequest= new NormalReportRequest;
$req->setNormalReportRequest($normalReportRequest);
$openApiSysDto= new OpenApiSysDto;
$req->setOpenApiSysDto($openApiSysDto);

$resp = $c->execute($req, $c->accessToken);

```

--------------------------------

### Python Request Example for Get Bound Unit List

Source: https://opendoc.jd.com/ads_api/jzt/api/word/advertise/dmp/mediaTarget/%E8%8E%B7%E5%8F%96%E4%BA%BA%E7%BE%A4%E5%B7%B2%E7%BB%91%E5%AE%9A%E7%9A%84%E5%8D%95%E5%85%83%E5%88%97%E8%A1%A8.html

Provides a Python example for fetching bound unit lists. This snippet uses the jd.api library and includes basic error handling.

```python
import jd.api
import json
from jd.api.rest.DmpNewCrowdGroupRefjsonRequest import DmpNewCrowdGroupRefjsonRequest
jd.setDefaultAppInfo(appkey, secret)
a = DmpNewCrowdGroupRefjsonRequest(url,port)
 a.accessPin = "abc" 
 a.authType = "abc" 
 a.crowdId = 123L 
 a.crowdBusinessRef = 123 
 a.siteId = 123 
 a.jdMediaUserId = 123L 
 
try:
f= a.getResponse(sessionkey)
print(json.dumps(f, ensure_ascii=False))
except Exception,e:
print(e)
```
Tokens:
Raw