对象标签 API (Beta)
对象标签可在一个标签中存储有关用户的结构化数据。Object 类型的标签保存一个带有命名字段的对象,例如最近一笔 order 及其 amount 和 status。ObjectList 类型的标签保存此类对象的数组,例如所有 orders。字段本身也可以是一个对象或对象列表,例如 profile 的 address。您只需定义一次字段,即可通过标签 API 写入和读取值,按字段值构建细分,并使用 Liquid 将值插入消息。
对象标签的工作原理
Anchor link to对象标签包含架构和值。架构是标签名称和字段列表,每个字段都有自己的类型。值存储在字段中,每个用户单独存储。
- 字段。 每个字段都是一个名为
<object>.<field>的标签,例如order.amount。您可以按字段进行细分,也可以通过此名称写入Object标签的字段。 Object值。 每个用户一个对象,例如"order": {"amount": 120, "status": "paid"}。ObjectList值。 具有相同字段的对象数组,例如"orders": [{"amount": 120, "status": "paid"}, {"amount": 50}]。- 嵌套对象。 类型为
OBJECT且拥有自己字段的字段,例如带有字段profile.address.city的profile.address。 - 嵌套列表。 类型为
OBJECT_LIST的字段,即对象标签内的对象数组,例如profile.visits。请参阅 嵌套对象和嵌套列表。
在 API 中,标签和字段的类型为 OBJECT 和 OBJECT_LIST。在控制面板中,它们显示为 对象 和 对象列表。在本页中,对象列表指 ObjectList 标签或嵌套列表。
对象标签始终是 User-specific 标签,即值属于用户而非单个设备,并会复制到该用户的所有设备上。有关常规标签,请参阅 标签 API。
嵌套对象和嵌套列表
Anchor link to对象标签的字段可以包含自己的字段,而不是单个值。嵌套对象是 OBJECT 类型的字段,保存一个对象。嵌套列表是 OBJECT_LIST 类型的字段,保存一个对象列表。列表中的元素也可以包含嵌套对象和嵌套列表。每个字段都保留其以点分隔的完整名称,例如 profile.address.city,您可以按这些名称进行细分。
例如,OBJECT 类型的 profile 标签和 OBJECT_LIST 类型的 orders 标签可以具有以下结构:
profile OBJECT├── address OBJECT│ ├── city STRING│ └── geo OBJECT│ └── lat STRING└── visits OBJECT_LIST └── code STRING
orders OBJECT_LIST├── sku STRING├── meta OBJECT│ └── color STRING└── lines OBJECT_LIST └── qty INTEGER可搜索字段和仅存储字段
Anchor link to字段的用途取决于其上层有多少个对象列表:
- 字段上层没有列表。 您可以按
profile.address.city这类字段进行细分,按其完整名称单独写入,并在消息中使用。 - 字段上层有一个列表。 您可以按
profile.visits.code或orders.meta.color这类字段进行细分,并在消息中使用。只能作为整个列表的一部分写入。 - 字段上层有两个列表。
orders.lines.qty这类字段仅存储。可以在 消息 中使用,但不能用于细分。
Pushwoosh 对对象标签(包括嵌套对象和嵌套列表)应用以下限制:
| 限制 | 值 | 超出时 |
|---|---|---|
| 嵌套深度 | 3 层对象和列表。标签本身是第一层,因此 profile.address.geo 是允许的最深对象 | 架构方法返回 HTTP 400,请参阅 错误 |
| 单个对象中的字段 | 1 到 20 个,适用于标签以及每个嵌套对象或嵌套列表 | 架构方法返回 HTTP 400,请参阅 错误 |
| 单个对象标签中带值的字段 | 50 个,包括嵌套字段。OBJECT 和 OBJECT_LIST 类型的字段不计入 | 架构方法返回 HTTP 400,请参阅 错误 |
| 完整字段名称 | 64 个字符,例如 profile.address.city | 架构方法返回 HTTP 400,请参阅 错误 |
| 单个对象列表中的元素 | 100 个,适用于标签以及每个嵌套列表 | 整个写入的值被拒绝 |
| 单个写入值的大小 | 64 KB JSON | 整个写入的值被拒绝 |
被拒绝的值的处理方式与字段类型错误的值相同,请参阅 写入会替换整个值。
架构规则
Anchor link to在您创建对象标签或添加字段时,Pushwoosh 会检查以下规则:
- 对象名称和字段名称只能包含拉丁字母、数字和
_。 - 标签以及每个嵌套对象或嵌套列表有 1 到 20 个字段。其他 限制 同样适用。字段名称不区分大小写,因此
Amount和amount是同一个字段。 - 字段的类型为以下之一:
INTEGER、STRING、LIST、DATE、BOOLEAN、PRICE、VERSION、OBJECT、OBJECT_LIST。OBJECT或OBJECT_LIST类型的字段需要有自己的fields。不支持时区字段。 - 字段不能使用其他标签已有的名称。如果标签
order.note已存在,向order添加字段note会失败并返回tag order.note already exists。 - 对象不能删除其最后一个字段。请改为删除该对象。
- 正在使用的字段或对象标签无法删除。如果嵌套对象或嵌套列表中的任何内容正在使用,则该嵌套对象或嵌套列表视为正在使用。错误信息会列出其使用位置,例如
field is in use: segment Big buyers, in-app Spring sale。引用该标签的细分、In-App、正在运行的 Customer Journey 活动、预设、电子邮件模板及其他项目均计为使用。
在控制面板中管理对象标签
Anchor link to在控制面板中创建不含嵌套对象和嵌套列表的对象标签:
- 在控制面板的 标签 页面上,点击 创建标签。
- 输入 标签名称。
- 在 值类型 中,选择 对象 或 对象列表。
- 在 字段 下,输入第一个字段的名称。
- 选择该字段的类型。
- 如需添加其他字段,点击 添加字段。
- 点击 创建。
在标签页面上,可以添加字段,或点击字段旁的 删除 将其删除。控制面板无法创建嵌套对象或嵌套列表,也无法更改其字段。通过 API 创建的嵌套对象或嵌套列表在控制面板中显示为一个 对象 或 对象列表 类型的字段。删除该字段会将其连同其中的所有内容一起删除。
管理架构
Anchor link to使用以下 REST 方法创建和更改对象标签。/json/1.3/addTag 仅用于常规标签,因为它无法定义字段。
基础 URL
Anchor link tohttps://rpc-api.svc-nue.pushwoosh.com身份验证
Anchor link to每个请求都必须包含一个 Authorization 标头,其中包含您的 服务器 API 令牌。使用设备 API 令牌会返回 HTTP 403 a device API token cannot call this method, use an account API token。
Authorization: Api YOUR_API_TOKEN以下方法用于管理对象标签的架构并读取其字段的值:
| 方法 | 路径 | 描述 |
|---|---|---|
POST | /api/tags | 创建对象标签及其字段 |
GET | /api/tags/{name} | 获取对象标签及其字段 |
GET | /api/tags | 列出标签。对象标签会附带其所有 fields(包括嵌套字段)返回,字段不会作为单独的标签列出 |
POST | /api/tags/{name}/fields | 向对象标签、嵌套对象或嵌套列表添加字段 |
DELETE | /api/tags/{name}/fields/{field} | 删除字段、嵌套对象或嵌套列表 |
DELETE | /api/tags/{name} | 删除对象标签及其所有字段 |
GET | /api/tags:values | 列出字段的已存储值,请参阅 字段的已存储值 |
POST /api/tags 返回对象标签,两个字段方法返回 {name} 中指定的对象在更改后的状态,包装在 {"tag": {...}} 中。DELETE /api/tags/{name} 返回 {}。
如果您的账户未启用对象标签,使用对象类型调用 POST /api/tags 以及两个字段方法都会失败并返回 HTTP 403 object tags are not enabled for the account。GET /api/tags/{name} 和 DELETE /api/tags/{name} 返回 HTTP 404 tag not found,GET /api/tags 不会列出对象标签。未启用对象标签时,您无法创建对象标签,因此也就没有可写入值的对象。
创建对象标签
Anchor link toPOST /api/tags
请求正文
Anchor link to| 名称 | 类型 | 描述 |
|---|---|---|
| name* | string | 对象标签的名称。 |
| type* | string | OBJECT 表示单个对象,OBJECT_LIST 表示对象列表。 |
| fields* | array | 对象的字段,1 到 20 个。 |
| fields[].name* | string | 字段名称。该字段会成为标签 <name>.<fields[].name>。 |
| fields[].type* | string | 字段类型:INTEGER、STRING、LIST、DATE、BOOLEAN、PRICE、VERSION、OBJECT 或 OBJECT_LIST。 |
| fields[].fields | array | 嵌套对象或嵌套列表的字段,1 到 20 个,格式相同。OBJECT 和 OBJECT_LIST 类型必填,其他类型忽略。 |
{ "name": "orders", "type": "OBJECT_LIST", "fields": [ { "name": "amount", "type": "INTEGER" }, { "name": "status", "type": "STRING" } ]}{ "tag": { "name": "orders", "type": "OBJECT_LIST", "system": false, "user_specific": true, "has_right_ace_modify": true, "fields": [ { "name": "amount", "type": "INTEGER", "fields": [] }, { "name": "status", "type": "STRING", "fields": [] } ] }}无论 user_specific 的值是什么,该标签都会创建为 User-specific 标签。GET /api/tags/{name} 返回相同的对象,但不带 tag 包装。字段按名称排序,没有嵌套字段的字段会附带一个空的 fields 数组。
如需创建嵌套对象和嵌套列表,请为字段指定 OBJECT 或 OBJECT_LIST 类型及其自己的 fields。一个请求即可创建整个结构:
{ "name": "profile", "type": "OBJECT", "fields": [ { "name": "address", "type": "OBJECT", "fields": [ { "name": "city", "type": "STRING" }, { "name": "geo", "type": "OBJECT", "fields": [{ "name": "lat", "type": "STRING" }] } ] }, { "name": "visits", "type": "OBJECT_LIST", "fields": [{ "name": "code", "type": "STRING" }] } ]}嵌套字段返回时使用相对于其所属对象的名称,例如 address 中的 city。GET /api/tags/{name} 只接受标签本身的名称。profile.address 这类嵌套名称会返回 HTTP 404 tag not found。
添加字段
Anchor link toPOST /api/tags/{name}/fields
{ "field": { "name": "note", "type": "STRING" }}如需向嵌套对象或嵌套列表添加字段,请在 {name} 中填写其完整名称,例如 POST /api/tags/profile.address/fields 或 POST /api/tags/profile.visits/fields。新字段可以是带有自己 fields 的嵌套对象或嵌套列表:
{ "field": { "name": "company", "type": "OBJECT", "fields": [{ "name": "title", "type": "STRING" }] }}您可以立即将新字段作为整个标签值的一部分写入。如果对象已有 20 个字段、该字段超出其他 限制,或已存在具有该完整字段名称的标签,添加字段会失败,请参阅 错误。
删除字段
Anchor link toDELETE /api/tags/{name}/fields/{field}
例如,DELETE /api/tags/orders/fields/note 会删除字段 orders.note。如需删除嵌套对象或嵌套列表的字段,请在 {name} 中填写其完整名称:DELETE /api/tags/profile.address/fields/city。
删除嵌套对象或嵌套列表会删除其中的所有内容:DELETE /api/tags/profile/fields/address 也会删除 profile.address.city 和 profile.address.geo。您无法删除对象的最后一个字段,也无法删除正在使用的字段、嵌套对象或嵌套列表,请参阅 错误。
错误的格式为 {"code": <n>, "message": "...", "details": [...]}。创建对象标签时,400 错误消息的格式为 validate: rpc error: code = InvalidArgument desc = <message>,其中 <message> 是表中的文本。在这些消息中,<object> 是对象的完整名称,例如 profile.address。
| HTTP 状态 | 消息 | 原因 |
|---|---|---|
| 400 | object tag and field names must contain only letters, digits and underscores | 名称包含其他字符。 |
| 400 | <object>: an object needs 1 to 20 fields | 创建时,标签、嵌套对象或嵌套列表没有字段或字段超过 20 个。 |
| 400 | an object has at most 20 fields | 要添加字段的对象已有 20 个字段。 |
| 400 | <object>.<field>: objects nest at most 3 levels deep | OBJECT 或 OBJECT_LIST 字段将处于第四层。 |
| 400 | an object tag holds at most 50 fields with values, nested ones included | 对象标签带值的字段将超过 50 个。 |
| 400 | field <name> is given twice | 两个字段名称相同(不区分大小写)。 |
| 400 | <object>.<field>: object and field names together cannot be longer than 64 characters | 完整字段名称过长。 |
| 400 | <object>.<field>: field type must be INTEGER, STRING, LIST, DATE, BOOLEAN, PRICE, VERSION, OBJECT or OBJECT_LIST | 不支持的字段类型。 |
| 400 | an object needs at least one field; delete the object instead | 您尝试删除对象的最后一个字段。 |
| 400 | field is in use: ..., tag is in use: ... | 该字段、嵌套对象或嵌套列表中的某项内容,或该对象标签正在被细分、In-App、Customer Journey 活动或其他项目使用。 |
| 403 | object tags are not enabled for the account | 该账户未启用对象标签。 |
| 403 | a device API token cannot call this method, use an account API token | 请求使用了设备 API 令牌。 |
| 404 | tag not found | GET 或 DELETE /api/tags/{name}:不存在该标签、该名称是字段,或未启用对象标签。 |
| 404 | object tag not found, field not found | 字段方法:不存在该对象标签、嵌套对象、嵌套列表或字段。如果 {name} 是带值的字段,也会返回 object tag not found。 |
| 409 | tag already exists | 已存在与对象标签同名的标签。 |
| 409 | tag <object>.<field> already exists | 已存在与该字段完整名称同名的标签。 |
使用 /setTags 和 /bulkSetTags 写入对象标签值。这些方法保留各自的身份验证方式:/setTags 在 Authorization: Token 标头中使用设备 API 令牌,/bulkSetTags 在 auth 中使用 API 访问令牌。将 Object 值作为 JSON 对象发送,将 ObjectList 值作为对象数组发送:
{ "request": { "application": "XXXXX-XXXXX", "userId": "user_42", "tags": { "order": { "amount": 120, "status": "paid" }, "orders": [ { "amount": 120, "status": "paid" }, { "amount": 50 } ] } }}如果按 HWID 设置值,该值会存储在该设备所属的用户上。架构方法的 基础 URL 上的 POST /api/devices:set_tags 按相同规则写入对象标签。其响应会以扁平名称列出对象的字段,例如 "profile.address.city"。
嵌套对象接受 JSON 对象,嵌套列表接受对象数组:
"tags": { "profile": { "address": { "city": "Berlin", "geo": { "lat": "52.5" } }, "visits": [{ "code": "v1" }] }, "orders": [ { "sku": "A-1", "meta": { "color": "red" }, "lines": [{ "qty": 2 }, { "qty": 3 }] } ]}每个字段接受其类型格式的值:
| 字段类型 | 示例值 |
|---|---|
INTEGER | 120 |
STRING | "paid" |
LIST | ["gift", "express"] |
DATE | "2026-10-02 22:11"(UTC)、"2026-10-02" 或以秒为单位的 Unix 时间戳 |
BOOLEAN | true 或 false |
PRICE | 19.95 |
VERSION | "1.0.0" |
写入会替换整个值
Anchor link to每次写入都会替换对象标签的已存储值:
- 新值中缺少的字段会被删除。以
null发送的字段也会被删除。 null、[]或""会删除整个值。{}会删除Object标签的所有字段。- 不属于该对象字段的键会被跳过。
- 如果任一层级的字段值与字段类型不匹配,则该标签的整个值都会被拒绝,已存储的值保持不变。如果值超出 限制,即列表超过 100 个元素或 JSON 超过 64 KB,也会如此。
/setTags 不会在响应中报告被拒绝的值,并返回 HTTP 200。请使用 /getTags 检查结果,或使用 /bulkSetTags,它会为每个标签报告结果。
隐藏字段
Anchor link to隐藏字段是 Pushwoosh 为自身用途标记为隐藏的字段。您无法使用本页的架构方法创建或隐藏字段。/getTags 不返回隐藏字段,因此您读取后再写回的值永远不会包含它们。写入时隐藏字段的处理方式取决于类型:
Object。 新值中缺少的隐藏字段会被保留,任一层级均如此。新值中缺少的可见嵌套对象会连同其中的所有内容一起删除,包括隐藏字段。删除整个值也会删除隐藏字段。ObjectList。 写入列表会替换其所有元素,旧元素的隐藏字段会丢失。元素没有标识符,因此新元素无法与旧元素对应。嵌套列表同样如此。
写入 Object 的一部分
Anchor link to按完整名称写入 Object 标签的单个字段、嵌套对象或嵌套列表,而不是整个标签值。increment 以及 /setTags 的其他操作都适用于字段:
"tags": { "order.status": "shipped", "order.amount": { "operation": "increment", "value": 5 }}这同样适用于上层只有对象的嵌套对象字段,例如 "profile.address.city": "Paris"。
上层只有对象的嵌套对象或嵌套列表可以按其完整名称单独写入,例如 profile.address 或 profile.visits。该值只替换它本身,profile 的其余部分保持不变。100 个元素和 64 KB 的 限制 从此值开始计算:
"tags": { "profile.address": { "city": "Paris" }, "profile.visits": [{ "code": "v2" }]}对象列表中的任何内容都无法单独写入,因为无法确定要更改哪个元素。这包括 ObjectList 标签的字段(例如 orders.sku),以及元素中的所有内容(例如 orders.meta 或 profile.visits.code)。/setTags 会忽略此类值。请改为发送整个列表。
对象标签不会自动创建
Anchor link to如果某个标签不存在,为其传入对象或对象数组的值会被跳过。标签自动创建不会创建对象标签,因此请先使用 POST /api/tags 创建架构。
bulkSetTags 结果
Anchor link to使用 detailed=true 时,除 ok、tag not found 和 wrong value. expect :<type> 外,/bulkSetTags 状态 还会为对象标签返回以下结果之一:
| 结果 | 原因 |
|---|---|
object tags are stored on the user only | 对象标签不是 User-specific 标签。 |
cannot load the fields of the object | Pushwoosh 无法读取对象标签的字段。 |
wrong value. expect an object (a map) or, for a list of objects, an array of maps | 值不适用于该对象标签、任一层级的字段值与其类型不匹配,或值超出 限制。 |
a field of a list of objects cannot be set on its own, set the whole list | 值被设置到对象列表中的某项内容上,例如 orders.sku 或 orders.meta。 |
/getTags 将 Object 值作为 JSON 对象返回,将 ObjectList 值作为对象数组返回:
{ "status_code": 200, "status_message": "OK", "response": { "result": { "order": { "amount": 120, "status": "paid" }, "orders": [ { "amount": 120, "status": "paid" }, { "amount": 50 } ] } }}任一层级的嵌套对象和嵌套列表都以与 写入 时相同的结构返回,例如 "profile": {"address": {"city": "Berlin"}, "visits": [{"code": "v1"}]}。
字段值的返回方式与 /getTags 中常规标签值相同:Date 以秒为单位的 Unix 时间戳返回,Price 以字符串形式返回(例如 "120.00"),Boolean 以 1 或 0 返回。
字段的已存储值
Anchor link to在 基础 URL 上调用 GET /api/tags:values 会列出字段包含的不同值,以及每个值对应的订阅者数量。在 name 中传入字段的完整名称,例如 profile.address.city 或 orders.sku。
查询参数
Anchor link to| 名称 | 类型 | 描述 |
|---|---|---|
| application* | string | 应用程序代码,XXXXX-XXXXX。 |
| name* | string | 字段的完整名称。 |
| like | string | 仅返回在 like_op 指定的位置包含此文本的值。 |
| like_op | string | STARTS_WITH(默认)、ENDS_WITH 或 CONTAINS。 |
| order_by | string | VALUE(默认)或 COUNT。 |
| order_direction | string | ASC(默认)或 DESC。 |
| limit | integer | 要返回的值的数量。默认为 100。 |
| offset | integer | 要跳过的值的数量。 |
| page | integer | 页码,从 0 开始。与 per_page 一起使用,代替 limit 和 offset。 |
| per_page | integer | 每页的值的数量。 |
GET /api/tags:values?application=XXXXX-XXXXX&name=orders.sku&order_by=COUNT&order_direction=DESC{ "values": [ { "value": "A-1", "count": 120 }, { "value": "B-2", "count": 45 } ], "total": 2, "page": 0, "per_page": 100}Integer 和 Price 字段不返回任何值,与这些类型的常规标签相同。对象标签、嵌套对象或嵌套列表本身没有自己的值,因此使用其名称会返回 HTTP 404 tag not found。
按字段细分
Anchor link to请对字段设置细分条件,而不是对对象标签本身设置。在 细分语言 中,字段是名称中带点的标签,并使用其自身类型的运算符:
AT("XXXXX-XXXXX", "order.amount", gte, 100)嵌套对象或嵌套列表的字段使用其完整名称,例如 profile.address.city、profile.visits.code 或 orders.meta.color。对对象标签本身、嵌套对象或嵌套列表(例如 profile.address)设置的条件会失败并返回 object tag has no value of its own, use one of its fields。
上层有两个对象列表的字段(例如 orders.lines.qty)仅存储。包含此类条件的细分可以保存,但计算该细分或向其发送消息会失败并返回 a field inside a list nested in a list is stored only and cannot be searched。
ObjectList 上的条件
Anchor link to当列表中至少有一个元素符合条件时,ObjectList 标签字段上的条件即匹配该用户。用 AND 连接的同一列表字段上的条件必须匹配同一个元素:
AT("XXXXX-XXXXX", "orders.amount", gte, 100) * AT("XXXXX-XXXXX", "orders.status", eq, "paid")此细分包含至少有一笔订单同时满足金额为 100 或以上且已支付的用户。如果用户有一笔未支付的大额订单和一笔已支付的小额订单,则不匹配。对于元素内对象的字段,同样检查同一个元素:orders.sku 等于 A-1 AND orders.meta.color 等于 red 匹配有一笔订单同时满足这两项的用户。用 OR 连接的条件不必匹配同一个元素。两个不同列表上的条件会在各自的列表上分别检查。
某些运算符在 ObjectList 标签的字段上的工作方式不同:
notset。 列表中没有任何元素在此字段中有值。没有该列表的用户也匹配。noteq。 至少有一个元素在此字段中有值,且该值与给定值不同。没有该字段的元素不计入。订单状态为paid和new的用户匹配noteq "paid"。- List 字段上的
notin。 没有任何元素包含任一给定值。 - 其他类型字段上的
notin。 至少有一个元素在此字段中的值不在给定值之中。
notset 和 List 字段上的 notin 不会与用 AND 连接的其他条件绑定到同一个元素。这些规则同样适用于嵌套列表,例如 profile.visits。
在消息中使用值
Anchor link to使用 Liquid 模板 将对象标签的字段插入推送通知、电子邮件、SMS 以及 WhatsApp 等即时通讯消息中。只有在您的账户启用了内容模板时,Liquid 才能使用。任一层级的字段都按其完整名称书写:
Your city is {{ profile.address.city }}.按索引获取对象列表中的元素,索引从 0 开始:
Your first order is {{ orders[0].sku }}, quantity {{ orders[0].lines[0].qty }}.超出列表末尾的索引,或用户没有的列表,会渲染为空字符串。请先检查该元素,或使用 default 设置备用值:
{% if orders[0] %}Your first order is {{ orders[0].sku }}.{% endif %}Your first order is {{ orders[0].sku | default: "on its way" }}.遍历对象列表,包括元素内的列表:
{% for o in orders %}{{ o.meta.color }}{% for l in o.lines %}{{ l.qty }}{% endfor %}{% endfor %}仅存储字段(例如 orders.lines.qty)在模板中的用法与其他字段相同。
导出包含对象标签的细分
Anchor link to/exportSegment 会导出对象标签的字段:
- CSV。 每个有值的字段是一个以其完整名称命名的单独列,例如
order.amount或profile.address.city。对象标签、嵌套对象和嵌套列表本身没有列。对象列表中任一层级的字段以 JSON 数组形式保存所有元素中的不同值,与 List 标签相同:["A-1","B-2"]。该数组已排序,不显示值来自哪个元素,因此也不保留元素的顺序。要获取完整的元素,请以json或json_each_line格式导出。 json和json_each_line。 对象标签以嵌套形式返回,结构与/getTags返回的相同。Object标签是tags中的一个条目,其字段位于object.fields下,其中的嵌套对象也在每一层将自己的字段放在object.fields下。ObjectList标签是一个条目,其元素位于object_list.items中,嵌套列表也是如此。字段使用短名称,按名称排序,其值位于以类型命名的键下:integer、string、list、date、boolean、price或version:
{ "name": "profile", "object": { "fields": [ { "name": "address", "object": { "fields": [{ "name": "city", "string": "Berlin" }] } }, { "name": "visits", "object_list": { "items": [{ "fields": [{ "name": "code", "string": "v1" }] }] } } ] }}ObjectList 标签如下所示。整数值以字符串形式返回:
{ "name": "orders", "object_list": { "items": [ { "fields": [{ "name": "amount", "integer": "120" }, { "name": "status", "string": "paid" }] }, { "fields": [{ "name": "amount", "integer": "50" }] } ] }}包含嵌套对象和嵌套列表的元素如下所示:
{ "fields": [ { "name": "meta", "object": { "fields": [{ "name": "color", "string": "red" }] } }, { "name": "lines", "object_list": { "items": [{ "fields": [{ "name": "qty", "integer": "2" }] }] } } ]}如果 tagsList 指定了对象标签,则会导出其所有字段,包括嵌套字段。