/basicOpen/multiplatform/ads/queryGmvItemGroupReportList{
"operation": {
"method": "POST",
"path": "/basicOpen/multiplatform/ads/queryGmvItemGroupReportList"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 1,
"text": ""
},
"requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/multiplatform/ads/queryGmvItemGroupReportList?access_token=value×tamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n \"endDate\": \"2024-11-17\",\n \"length\": 20,\n \"page\": 1,\n \"startDate\": \"2024-11-01\",\n \"advertiserIds\": [123456789012345],\n \"bidTypeCodes\": [\"CUSTOM\",\"NO_BID\"],\n \"campaignIds\": [123456789012345],\n \"itemGroupIds\": [123456789012345],\n \"orderField\": \"grossRevenue\",\n \"orderType\": \"DESC\",\n \"ownerBcIds\": [123456789012345],\n \"status\": [\"available\",\"unavailable\"],\n \"storeIds\": [123456789012345],\n \"summaryCurrency\": \"USD\"\n}'",
"responseExample": {
"code": 0,
"message": "success",
"error_details": [],
"request_id": "a0d54debf93140f3b58d1ed81e8e3583.178.17255922733991817",
"response_time": "2024-11-12 16:00:00",
"data": {
"list": [
{
"bidTypeCode": "CUSTOM",
"bidTypeName": "目标ROI",
"currencyCode": "USD",
"currencyRateMissingCount": "0",
"enabledCampaignId": "123456789012345",
"enabledCampaignName": "双十一推广系列",
"endDate": "2024-11-01",
"grossRevenue": "251.25",
"itemGroupId": "123456789012345",
"orders": "10",
"productImageUrl": "https://example.com/product.jpg",
"productStatusCode": "available",
"productStatusName": "可用",
"startDate": "2024-11-01",
"storeCode": "STORE001",
"storeId": "123456789012345",
"storeName": "旗舰店",
"subjectId": "REPORT_123456",
"title": "iPhone 15 Pro Max",
"reportDate": "2024-11-01",
"cost": 100.5,
"costPerOrder": 10.05,
"roi": 2.5
}
],
"total": 100
},
"total": 1
}
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | endDate | 结束日期 | string | — | 可选 | 结束日期,必填,格式:yyyy-MM-dd,与开始日期间隔不超过31天 |
| 2 | length | 每页条数 | integer | — | 可选 | 每页条数,必填,小于2000 |
| 3 | page | 页码 | integer | — | 可选 | 页码,必填 |
| 4 | startDate | 开始日期 | string | — | 可选 | 开始日期,必填,格式:yyyy-MM-dd |
| 5 | advertiserIds | 广告账号ID列表 | array<any> | — | 可选 | 广告账号ID列表,Long数组 |
| 6 | bidTypeCodes | 优化模式编码列表 | array<any> | — | 可选 | 优化模式编码列表,String数组,枚举值:CUSTOM-目标ROI, NO_BID-最大投放量 |
| 7 | campaignIds | 推广系列ID列表 | array<any> | — | 可选 | 推广系列ID列表,Long数组 |
| 8 | itemGroupIds | 广告商品ID列表 | array<any> | — | 可选 | 广告商品ID列表,Long数组 |
| 9 | orderField | 排序字段 | string | — | 可选 | 排序字段 |
| 10 | orderType | 排序方式 | string | — | 可选 | 排序方式,枚举值:ASC-升序, DESC-降序 |
| 11 | ownerBcIds | 广告主账号ID列表 | array<any> | — | 可选 | 广告主账号ID列表,Long数组 |
| 12 | status | 商品状态编码列表 | array<any> | — | 可选 | 商品状态编码列表,String数组,枚举值:available-可用, unavailable-不可用 |
| 13 | storeIds | 店铺ID列表 | array<any> | — | 可选 | 店铺ID列表,Long数组 |
| 14 | summaryCurrency | 汇总币种编码 | string | — | 可选 | 汇总币种编码 |
| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | code | 响应码 | integer | — | 必填 | 响应码 |
| 2 | data | 返回数据 | object | — | 必填 | 返回数据 |
| 2.1 | list | 报告列表 | array<object> | — | 必填 | 报告列表,Report对象数组 |
| 2.1.1 | bidTypeCode | 优化模式编码 | string | CUSTOM | 必填 | 优化模式编码,枚举值:CUSTOM-目标ROI, NO_BID-最大投放量 |
| 2.1.2 | bidTypeName | 优化模式名称 | string | 目标ROI | 必填 | 优化模式名称 |
| 2.1.3 | currencyCode | 币种编码 | string | USD | 必填 | 币种编码 |
| 2.1.4 | currencyRateMissingCount | 币种汇率缺失计数 | string | 0 | 必填 | 币种汇率缺失计数 |
| 2.1.5 | enabledCampaignId | 启用的推广系列ID | string | 123456789012345 | 必填 | 启用的推广系列ID |
| 2.1.6 | enabledCampaignName | 启用的推广系列名称 | string | 双十一推广系列 | 必填 | 启用的推广系列名称 |
| 2.1.7 | endDate | 结束日期 | string | 2024-11-17 | 必填 | 结束日期,格式:yyyy-MM-dd |
| 2.1.8 | grossRevenue | 总收入 | string | 12345.67 | 必填 | 总收入 |
| 2.1.9 | itemGroupId | 商品SPU ID | string | 123456789012345 | 必填 | 商品SPU ID |
| 2.1.10 | orders | 订单数 | string | 150 | 必填 | 订单数 |
| 2.1.11 | productImageUrl | 商品图片URL | string | https://example.com/product.jpg | 必填 | 商品图片URL |
| 2.1.12 | productStatusCode | 商品状态编码 | string | available | 必填 | 商品状态编码,枚举值:available-可用, unavailable-不可用 |
| 2.1.13 | productStatusName | 商品状态名称 | string | 可用 | 必填 | 商品状态名称 |
| 2.1.14 | startDate | 开始日期 | string | 2024-11-01 | 必填 | 开始日期,格式:yyyy-MM-dd |
| 2.1.15 | storeCode | 店铺编码 | string | STORE001 | 必填 | 店铺编码 |
| 2.1.16 | storeId | 店铺ID | string | 123456789012345 | 必填 | 店铺ID |
| 2.1.17 | storeName | 店铺名称 | string | 旗舰店 | 必填 | 店铺名称 |
| 2.1.18 | subjectId | 报告主体ID | string | REPORT_123456 | 必填 | 报告主体ID |
| 2.1.19 | title | 商品标题 | string | iPhone 15 Pro Max | 必填 | 商品标题 |
| 2.1.20 | reportDate | 当startDate与endDate一致时返回 | string | 2024-11-30 | 可选 | 当startDate与endDate一致时返回 |
| 2.1.21 | cost | 成本 | number | 100.5 | 必填 | 成本 |
| 2.1.22 | costPerOrder | 平均下单成本 | number | 10.05 | 必填 | 平均下单成本 |
| 2.1.23 | roi | roi | number | 2.5 | 必填 | ROI |
| 2.2 | total | 总记录数 | string | 1000 | 必填 | 总记录数 |
| 3 | error_details | 错误详情 | array<any> | — | 必填 | 错误详情 |
| 4 | message | 提示信息 | string | — | 必填 | 提示信息 |
| 5 | request_id | 请求id | string | — | 必填 | 请求id |
| 6 | response_time | 响应时间 | string | — | 必填 | 响应时间 |
| 7 | total | 总记录数 | integer | — | 必填 | 总记录数 |
领星ERP的接口:查询TikTok - GMV MAX - 广告商品(/basicOpen/multiplatform/ads/queryGmvItemGroupReportList),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。