文件内容
references/apis/bg-local-goods-partial-update.md
# 部分字段编辑 — `bg.local.goods.partial.update`
| 项 | 值 |
|----|-----|
| **脚本** | `scripts/us_manage_partial_update.py` |
| **Partner 文档** | https://partner-us.temu.com/documentation?menu_code=fb16b05f7a904765aac4af3a24b87d4a&sub_menu_code=6de74ed5afe74f89966b3ff23dfd7498 |
| **网关** | `POST /temu/proxy`，`type`=`bg.local.goods.partial.update`，业务载荷放在 Body 的 `params` |
**Description:** Edit a subset of the product properties (e.g. description, brand, images, attributes).
> 仅传需要修改的字段。官方请求体为 **`request` 对象**；`goodsServicePromise`、`goodsProperty`、`skuList` 等与 **`goodsBasic` 同级**，均在 `request` 下，**不要**把这些字段塞进 `goodsBasic`。
---
## Request 结构（官方顶层）
```text
params
└── request (OBJECT, 选填)
├── language
├── goodsId ← 必填
├── goodsBasic ← 仅基础信息（名称/图库/进口标识）
├── goodsServicePromise ← 与 goodsBasic 同级
├── goodsProperty
├── goodsOriginInfo
├── bulletPoints
├── goodsDesc
├── guideFileInfo
├── goodsSizeChartList
├── goodsSizeImage
├── skuList
├── goodsTrademark
├── goodsVehiclePropertyRelation
├── secondHand
├── modifyId
└── saveMode
```
### `request` 内字段一览
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| language | STRING | 否 | Language |
| goodsId | LONG | **是** | Product Number |
| goodsBasic | OBJECT | 否 | goods basic，见 [goodsBasic](#goodsbasic) |
| goodsServicePromise | OBJECT | 否 | goods service promise，见下 |
| goodsProperty | OBJECT | 否 | goods property，见下 |
| goodsOriginInfo | OBJECT | 否 | Country/region of Origin，见下 |
| bulletPoints | STRING[] | 否 | bullet points |
| goodsDesc | STRING | 否 | goods desc |
| guideFileInfo | OBJECT | 否 | guide file info，见下 |
| goodsSizeChartList | OBJECT | 否 | goods size chart list，见下 |
| goodsSizeImage | STRING[] | 否 | The URL of the size chart image |
| skuList | OBJECT[] | 否 | sku list，见下 |
| goodsTrademark | OBJECT | 否 | goods trademark，见下 |
| goodsVehiclePropertyRelation | OBJECT | 否 | Vehicle date，见下 |
| secondHand | OBJECT | 否 | second hand info，见下 |
| modifyId | STRING | 否 | Product information modification ID；goods 唯一，后续可凭此 ID 查审核结果 |
| saveMode | INTEGER | 否 | ERP product publish status：`1`=Submitted，`2`=Saved as draft |
### 网关 `params` 写法
推荐与官方一致，整体放入 **`request`**：
```json
{
"accessToken": "TOKEN",
"request": {
"goodsId": 123456,
"goodsBasic": { "goodsName": "New Title" }
}
}
```
若网关/Temu 要求展平，可将 `request` 内字段提到 `params` 顶层（`goodsId`、`goodsBasic`、`skuList` 等保持**同级**关系，仍不要把 `skuList` 放进 `goodsBasic`）。
---
## goodsBasic
仅包含 **goods basic** 相关字段（Partner 文档中 `goodsBasic` 子树）：
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| goodsName | STRING | 否 | goods name |
| goodsGallery | OBJECT | 否 | goods gallery，见下 |
| importDesignation | STRING | 否 | `Imported` / `Made in the USA` / `Made in the USA and Imported` / `Made in the USA or Imported` |
### `goodsBasic.goodsGallery`
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| detailVideo | OBJECT | 否 | Detail Video：`vid`、`videoUrl` |
| goodsCarouselImage | STRING[] | 否 | Product carousel images |
| detailImage | STRING[] | 否 | Product Detail Images |
| carouselVideo | OBJECT | 否 | Carousel Video：`vid`、`videoUrl` |
---
## request.goodsServicePromise
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| shipmentLimitDay | INTEGER | 否 | Stock Preparation Time - Days；可选 `1`、`2` |
| fulfillmentType | INTEGER | 否 | `1`=Self-Delivery，`2`=Platform Delivery |
| costTemplateId | STRING | 否 | Shipping Template ID |
---
## request.goodsProperty
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| goodsProperties | OBJECT[] | 否 | Product Attribute List |
**`goodsProperties[]`**
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| vid | LONG | 否 | 非自定义规格值时须传 vid |
| value | STRING | 否 | Attribute Value |
| valueUnit | STRING | 否 | Attribute Value Unit |
| valueUnitId | LONG | 否 | Attribute Value Unit ID |
| templatePid | LONG | 否 | Template Attribute Id |
| parentSpecId | LONG | 否 | 非销售属性可不填 |
| specId | LONG | 否 | 非销售属性可不填 |
| note | STRING | 否 | Note |
| imgUrl | STRING | 否 | Image URL |
| groupId | INTEGER | 否 | Attribute Value Group ID |
| refPid | LONG | 否 | Reference Property ID |
| numberInputValue | STRING | 否 | Numeric Input |
---
## request.goodsOriginInfo
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| originRegion1 | STRING | 否 | Primary Address（country or region） |
| originRegion2 | STRING | 否 | Secondary Address；**Primary=China 时必填** |
| agreeDefaultOriginRegion | BOOLEAN | 否 | 默认 `false` |
| proofImageUrls | STRING[] | 否 | 产地标签实拍 |
| labelManufacturerProofImageUrls | STRING[] | 否 | 标签特写，最多 5 张 |
---
## request.guideFileInfo
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| lang2GuideFileUrl | MAP | 否 | language → PDF URL；**须含英文** |
---
## request.goodsSizeChartList
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| goodsSizeChartList | OBJECT[] | 否 | 多套尺码表（套装） |
**数组元素：** `classId`、`meta`、`groups[]`（`id`、`name`、`elements[]`、`records[]`、`values[]`）、`bodyMeta`、`bodyRecords[]`。
---
## request.skuList[]
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| skuId | LONG | 条件 | **修改 SKU 必填**；**新增 SKU 勿传** |
| basePrice | OBJECT | 条件 | **修改勿传**；**新增必填** `{ amount, currency }` |
| listPrice | OBJECT | 否 | 须高于 basePrice |
| listPriceType | INTEGER | 否 | 空或 `0` 时必须填 listPrice |
| quantity | LONG | 条件 | **修改勿传**；**新增必填** |
| specIdList | LONG[] | 条件 | **修改勿传**；**新增必填** |
| outSkuSn | STRING | 否 | 修改时可选；不传保留，传 `""` 清空 |
| weight | STRING | **是** | weight |
| weightUnit | STRING | **是** | weight unit |
| length / width / height | STRING | **是** | 尺寸 |
| volumeUnit | STRING | **是** | volume unit |
| images | STRING[] | **是** | images |
| multiplePackage | OBJECT | 否 | `skuClassification`、`mixedSetType`、`numberOfPieces`、`pieceUnitCode`、`originNetContentNumber`、`originTotalNetContentNumber`、`netContentUnitCode`、`individuallyPacked` |
---
## request.goodsTrademark
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| brandId | LONG | 否 | Brand ID |
| trademarkId | LONG | 否 | Trademark ID |
| noTrademark | BOOLEAN | 否 | 默认 `false` |
---
## request.goodsVehiclePropertyRelation
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| relationId | LONG | 否 | relationType=`1` 时查兼容车型库 |
| ktype | LONG[] | 否 | K-type 映射 |
| leafPropertyValueDependencyIdList | LONG[] | 否 | 末级属性值 dependency id |
---
## request.secondHand
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| secondHandGoods | BOOLEAN | 否 | whether it's second hand |
| level | INTEGER | 否 | condition |
---
## Response
| 参数 | 类型 | 说明 |
|------|------|------|
| success | BOOLEAN | success |
| errorCode | INTEGER | error code |
| errorMsg | STRING | error message |
| result.goodsId | LONG | Product ID |
| result.productType | INTEGER | `1` Normal，`2` Custom，`3` Made-to-order |
| result.skuInfoList | OBJECT[] | Sku information list |
| result.skuInfoList[].skuId | LONG | Sku id |
| result.skuInfoList[].outSkuSn | STRING | External sku code |
| result.skuInfoList[].specList | OBJECT[] | `{ specId, parentSpecId }` |
---
## 示例
### 只改标题
```bash
python scripts/us_manage_partial_update.py '{
"accessToken": "TOKEN",
"request": {
"goodsId": 123456,
"goodsBasic": {
"goodsName": "Updated Title"
}
}
}'
```
### 改轮播图 + 提交状态
```bash
python scripts/us_manage_partial_update.py '{
"accessToken": "TOKEN",
"request": {
"goodsId": 123456,
"language": "en",
"goodsBasic": {
"goodsGallery": {
"goodsCarouselImage": ["https://..."]
}
},
"saveMode": 1
}
}'
```
### 修改已有 SKU（`skuList` 与 `goodsBasic` 同级）
```bash
python scripts/us_manage_partial_update.py '{
"accessToken": "TOKEN",
"request": {
"goodsId": 123456,
"skuList": [{
"skuId": 58224724203874,
"weight": "500",
"weightUnit": "g",
"length": "10",
"width": "10",
"height": "10",
"volumeUnit": "cm",
"images": ["https://..."]
}]
}
}'
```