Перейти к содержанию

API объектных тегов (бета)

Объектные теги хранят структурированные данные о пользователе в одном теге. Тег типа Object содержит один объект с именованными полями, например последний заказ order с полями amount и status. Тег типа ObjectList содержит массив таких объектов, например все заказы orders. Поле само может быть объектом или списком объектов, например адрес address в профиле profile. Вы один раз описываете поля, записываете и читаете значения через 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 с полем profile.address.city.
  • Вложенный список. Поле типа OBJECT_LIST, массив объектов внутри объектного тега, например profile.visits. См. Вложенные объекты и списки.

В API типы тегов и полей называются OBJECT и OBJECT_LIST. В Control Panel это Объект и Список объектов. На этой странице список объектов означает тег ObjectList или вложенный список.

Объектные теги всегда User-specific: значение принадлежит пользователю, а не отдельному устройству, и копируется на все устройства пользователя. Об обычных тегах см. API тегов.

Вложенные объекты и списки

Anchor link to

Поле объектного тега может содержать собственные поля вместо одного значения. Вложенный объект, поле типа OBJECT, содержит один объект. Вложенный список, поле типа OBJECT_LIST, содержит список объектов. Элемент списка тоже может содержать вложенные объекты и списки. Каждое поле сохраняет полное имя через точку, например profile.address.city, и по этим именам строятся сегменты.

Например, тег profile типа OBJECT и тег orders типа OBJECT_LIST могут иметь такую структуру:

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, только хранится. Используйте его в сообщениях, но не в сегментах.

Ограничения

Anchor link to

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 КБ 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, добавление поля note в order завершается ошибкой tag order.note already exists.
  • Объект не может лишиться последнего поля. Вместо этого удалите сам объект.
  • Поле или объектный тег, который используется, нельзя удалить. Вложенный объект или вложенный список считается используемым, если используется что-либо внутри него. В ошибке перечислено, где он используется, например field is in use: segment Big buyers, in-app Spring sale. Использованиями считаются сегменты, In-App, запущенные кампании Customer Journey, пресеты, шаблоны email и другие объекты, которые ссылаются на тег.

Управление объектными тегами в Control Panel

Anchor link to

Создайте объектный тег без вложенных объектов и списков в Control Panel:

  1. На странице Теги в Control Panel нажмите Создать тег.
  2. Введите Название тега.
  3. В поле Тип значения выберите Объект или Список объектов.
  4. В разделе Поля введите имя первого поля.
  5. Выберите тип поля.
  6. Чтобы добавить еще одно поле, нажмите Добавить поле.
  7. Нажмите Создать.

На странице тега можно добавить поле или нажать Удалить рядом с полем, чтобы удалить его. Control Panel не может создать вложенный объект или вложенный список или изменить его поля. Вложенный объект или вложенный список, созданный через API, отображается как одно поле типа Объект или Список объектов. При удалении такого поля удаляется и все, что находится внутри него.

Управление схемой

Anchor link to

Создавайте и изменяйте объектные теги с помощью REST-методов ниже. Используйте /json/1.3/addTag только для обычных тегов, потому что он не умеет описывать поля.

Базовый URL

Anchor link to
https://rpc-api.svc-nue.pushwoosh.com

Аутентификация

Anchor link to

Каждый запрос должен содержать заголовок Authorization с вашим Server API token. На запрос с Device API token возвращается HTTP 403 a device API token cannot call this method, use an account API token.

Authorization: Api YOUR_API_TOKEN

Эндпоинты

Anchor link to

Эти методы управляют схемой объектных тегов и читают значения их полей:

МетодПутьОписание
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 to

POST /api/tags

Тело запроса
Anchor link to
ИмяТипОписание
name*stringИмя объектного тега.
type*stringOBJECT для одного объекта или 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[].fieldsarrayПоля вложенного объекта или вложенного списка, от 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. Один запрос создает всю структуру:

Пример: тег profile из раздела «Вложенные объекты и списки»
{
"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" }]
}
]
}

Вложенные поля возвращаются с именами относительно своего объекта, например city внутри address. GET /api/tags/{name} принимает только имя самого тега. Вложенное имя, например profile.address, возвращает HTTP 404 tag not found.

Добавление поля

Anchor link to

POST /api/tags/{name}/fields

Пример: POST /api/tags/orders/fields
{
"field": { "name": "note", "type": "STRING" }
}

Чтобы добавить поле во вложенный объект или вложенный список, укажите его полное имя в {name}, например POST /api/tags/profile.address/fields или POST /api/tags/profile.visits/fields. Новое поле может быть вложенным объектом или вложенным списком с собственными fields:

Пример: POST /api/tags/profile/fields
{
"field": {
"name": "company",
"type": "OBJECT",
"fields": [{ "name": "title", "type": "STRING" }]
}
}

Новое поле можно сразу записывать в составе полного значения тега. Добавление поля завершается ошибкой, если у объекта уже 20 полей, если поле нарушает другое ограничение или если существует тег с полным именем поля, см. Ошибки.

Удаление поля

Anchor link to

DELETE /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. Нельзя удалить последнее поле объекта, а также поле, вложенный объект или вложенный список, который используется, см. Ошибки.

Ошибки

Anchor link to

Ошибки приходят в формате {"code": <n>, "message": "...", "details": [...]}. При создании объектного тега сообщение с кодом 400 имеет вид validate: rpc error: code = InvalidArgument desc = <message>, где <message> — текст из таблицы. В этих сообщениях <object> — полное имя объекта, например profile.address.

HTTP-статусСообщениеПричина
400object tag and field names must contain only letters, digits and underscoresВ имени есть другой символ.
400<object>: an object needs 1 to 20 fieldsПри создании у тега, вложенного объекта или вложенного списка нет полей или их больше 20.
400an object has at most 20 fieldsУ объекта, в который вы добавляете поле, уже 20 полей.
400<object>.<field>: objects nest at most 3 levels deepПоле типа OBJECT или OBJECT_LIST оказалось бы на четвертом уровне.
400an object tag holds at most 50 fields with values, nested ones includedУ объектного тега оказалось бы больше 50 полей со значениями.
400field <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Неподдерживаемый тип поля.
400an object needs at least one field; delete the object insteadПопытка удалить последнее поле объекта.
400field is in use: ..., tag is in use: ...Поле, что-либо внутри вложенного объекта или вложенного списка или объектный тег используется в сегментах, In-App, кампаниях Customer Journey или других объектах.
403object tags are not enabled for the accountОбъектные теги не включены для аккаунта.
403a device API token cannot call this method, use an account API tokenВ запросе используется Device API token.
404tag not foundGET или DELETE /api/tags/{name}: такого тега нет, имя принадлежит полю или объектные теги не включены.
404object tag not found, field not foundМетоды для полей: такого объектного тега, вложенного объекта, вложенного списка или поля нет. Если {name} — поле со значением, тоже возвращается object tag not found.
409tag already existsСуществует тег с именем объектного тега.
409tag <object>.<field> already existsСуществует тег с полным именем поля.

Запись значений

Anchor link to

Записывайте значения объектных тегов с помощью /setTags и /bulkSetTags. У этих методов своя аутентификация: /setTags принимает Device API token в заголовке Authorization: Token, а /bulkSetTags — токен доступа к API в auth. Передавайте значение Object как JSON-объект, а значение ObjectList — как массив объектов:

Пример: /json/1.3/setTags
{
"request": {
"application": "XXXXX-XXXXX",
"userId": "user_42",
"tags": {
"order": { "amount": 120, "status": "paid" },
"orders": [
{ "amount": 120, "status": "paid" },
{ "amount": 50 }
]
}
}
}

Если вы задаете значение по HWID, оно сохраняется у пользователя этого устройства. POST /api/devices:set_tags на базовом URL методов схемы записывает объектные теги по тем же правилам. В его ответе поля объектов перечислены плоскими именами, например "profile.address.city".

Вложенный объект принимает JSON-объект, а вложенный список — массив объектов:

Пример: вложенные значения в /json/1.3/setTags
"tags": {
"profile": {
"address": { "city": "Berlin", "geo": { "lat": "52.5" } },
"visits": [{ "code": "v1" }]
},
"orders": [
{ "sku": "A-1", "meta": { "color": "red" }, "lines": [{ "qty": 2 }, { "qty": 3 }] }
]
}

Каждое поле принимает значение в формате своего типа:

Тип поляПример значения
INTEGER120
STRING"paid"
LIST["gift", "express"]
DATE"2026-10-02 22:11" (UTC), "2026-10-02" или Unix-время в секундах
BOOLEANtrue или false
PRICE19.95
VERSION"1.0.0"

Запись заменяет все значение

Anchor link to

Каждая запись заменяет сохраненное значение объектного тега:

  • Поле, которого нет в новом значении, удаляется. Поле, переданное как null, тоже удаляется.
  • null, [] или "" удаляет все значение.
  • {} удаляет все поля тега Object.
  • Ключ, который не является полем объекта, пропускается.
  • Если значение поля на любом уровне вложенности не соответствует типу поля, все значение тега отклоняется, а сохраненное значение остается прежним. То же происходит, если значение нарушает ограничение: список больше чем из 100 элементов или больше 64 КБ JSON.

/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 КБ отсчитываются от этого значения:

"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 статус /bulkSetTags возвращает для объектного тега один из этих результатов в дополнение к ok, tag not found и wrong value. expect :<type>:

РезультатПричина
object tags are stored on the user onlyОбъектный тег не User-specific.
cannot load the fields of the objectPushwoosh не удалось прочитать поля объектного тега.
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.

Чтение значений

Anchor link to

/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

GET /api/tags:values на базовом URL возвращает список различных значений поля и количество подписчиков для каждого значения. Передайте полное имя поля в name, например profile.address.city или orders.sku.

Параметры запроса
Anchor link to
ИмяТипОписание
application*stringКод приложения, XXXXX-XXXXX.
name*stringПолное имя поля.
likestringВернуть только значения, которые содержат этот текст в позиции, заданной like_op.
like_opstringSTARTS_WITH (по умолчанию), ENDS_WITH или CONTAINS.
order_bystringVALUE (по умолчанию) или COUNT.
order_directionstringASC (по умолчанию) или DESC.
limitintegerКоличество возвращаемых значений. По умолчанию 100.
offsetintegerКоличество пропускаемых значений.
pageintegerНомер страницы, начиная с 0. Используется с per_page вместо limit и offset.
per_pageintegerКоличество значений на странице.
Пример
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".
  • notin для поля типа List. Ни один элемент не содержит ни одного из заданных значений.
  • notin для поля другого типа. Хотя бы у одного элемента в этом поле есть значение, которого нет среди заданных.

notset и notin для поля типа List не привязаны к тому же элементу, что и другие условия, объединенные через AND. Эти правила действуют и для вложенных списков, например profile.visits.

Использование значений в сообщениях

Anchor link to

Вставляйте поля объектных тегов в push-уведомления, email, SMS и сообщения мессенджеров, например WhatsApp, с помощью шаблонов Liquid. 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 выглядит так. Значения Integer выводятся как строки:

{
"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 указывает объектный тег, экспортируются все его поля, включая вложенные.