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 toPushwoosh применяет к объектным тегам, включая вложенные объекты и списки, такие ограничения:
| Ограничение | Значение | При превышении |
|---|---|---|
| Глубина вложенности | 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 toPushwoosh проверяет эти правила, когда вы создаете объектный тег или добавляете поле:
- Имена объектов и полей содержат только латинские буквы, цифры и
_. - У тега и у каждого вложенного объекта или вложенного списка от 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:
- На странице Теги в Control Panel нажмите Создать тег.
- Введите Название тега.
- В поле Тип значения выберите Объект или Список объектов.
- В разделе Поля введите имя первого поля.
- Выберите тип поля.
- Чтобы добавить еще одно поле, нажмите Добавить поле.
- Нажмите Создать.
На странице тега можно добавить поле или нажать Удалить рядом с полем, чтобы удалить его. Control Panel не может создать вложенный объект или вложенный список или изменить его поля. Вложенный объект или вложенный список, созданный через API, отображается как одно поле типа Объект или Список объектов. При удалении такого поля удаляется и все, что находится внутри него.
Управление схемой
Anchor link toСоздавайте и изменяйте объектные теги с помощью REST-методов ниже. Используйте /json/1.3/addTag только для обычных тегов, потому что он не умеет описывать поля.
Базовый URL
Anchor link tohttps://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 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" }] } ]}Вложенные поля возвращаются с именами относительно своего объекта, например city внутри address. 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. Нельзя удалить последнее поле объекта, а также поле, вложенный объект или вложенный список, который используется, см. Ошибки.
Ошибки
Anchor link toОшибки приходят в формате {"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 | В запросе используется Device API token. |
| 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 | Существует тег с полным именем поля. |
Запись значений
Anchor link toЗаписывайте значения объектных тегов с помощью /setTags и /bulkSetTags. У этих методов своя аутентификация: /setTags принимает Device API token в заголовке Authorization: Token, а /bulkSetTags — токен доступа к API в auth. Передавайте значение Object как JSON-объект, а значение ObjectList — как массив объектов:
{ "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-объект, а вложенный список — массив объектов:
"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 элементов или больше 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 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. |
Чтение значений
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 toGET /api/tags:values на базовом URL возвращает список различных значений поля и количество подписчиков для каждого значения. Передайте полное имя поля в 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".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 указывает объектный тег, экспортируются все его поля, включая вложенные.