Skip to content

Получение вложенности столбцов

Метод getobj.columns_tree
Описание Получение вложенности столбцов
Кому доступен Агент, Клиент
Необходимые компоненты для работы с методом Data API для настройки
Вес метода 1 балл

Параметры запроса

Название Тип Обязательный Описание
access_token string да Ключ сессии аутентификации
user_id number нет Уникальный идентификатор пользователя клиента агента от имени которого делается запрос
Является обязательным для агента
Для получения списка пользователей клиента необходимо использовать метод "get.customer_users"
report_type enum да Тип отчета пользователя. Для получения списка отчетов пользователей необходимо использовать метод "get.reports_list"

Параметры ответа

Название Тип Допустимые значения Ответ по умолчанию Описание
Группы столбцов
columns_groups array да Список групп столбцов
id number Идентификатор группы столбцов
name string Название группы столбцов
description string Описание группы столбцов. Отображается в подсказке
parent_group_id number Идентификатор группы столбцов в вложении которой находится данная группа столбцов
sort number Сквозной идентификатор, используемый для сортировки в дереве столбцов.
Столбцы
columns array да Список столбцов доступных пользователю в отчете
id string Мнемоника столбца
name string Название столбца
description string Описание столбца. Отображается в подсказке
group_id number Идентификатор группы столбцов в вложении которой находится данный столбец
sort number Сквозной идентификатор, используемый для сортировки в дереве измерений.
is_custom boolean Является ли столбец пользовательским.
type enum
  • metric - Столбец на основе метрики
  • formula - Столбец на основе формулы
  • Тип столбца. В зависимости от типа столбца нужно использовать соответствующие методы для редактирования и получения настроек.
    expression string Используемые условия фильтрации в столбце или формула для вычисления столбца. Отображается в подсказке
    data_type enum да Формат данных
    multichannel_model enum да Используемый способ мультиканального анализа
    is_transferable boolean да Возможен ли переход в другие отчеты по данному столбцу.
    is_pie_chart_available boolean Доступность стобца для отображени в графичевском виде круговой диаграммы(pie chart)
    is_available_dash_widgets boolean Доступность колонок для виджетов дашборда
    is_available_interactive_dash_widgets boolean Доступность колонок для интерактива в виджетах дашборда

    JSON структура запроса

    {
        "jsonrpc":"2.0",
        "id":"number",
        "method":"getobj.columns_tree",
        "params":{
            "access_token":"string",
            "user_id":"number",
            "report_type": "enum"
        }
    }
    

    JSON структура ответа

    {
        "jsonrpc": "2.0",
        "id": "number",
        "result": {
            "metadata": {
    
            },
            "data": {
                "columns_groups": [
                        {
                          "id": "number",
                          "name": "string",
                          "description": "string",
                          "parent_group_id": "number",
                          "sort": "number"
                        }
                ],
                "columns": [
                        {
                          "id": "string",
                          "name": "string",
                          "description": "string",
                          "group_id": "number",
                          "sort": "number",
                          "is_custom": "boolean",
                          "type": "enum",
                          "expression": "string",
                          "data_type": "enum",
                          "multichannel_model": "enum",
                          "is_pie_chart_available": "boolean",
                          "is_transferable": "boolean"
                        }
                ]
            }
        }
    }
    

    JSON Пример ответа

    {
        "jsonrpc": "2.0",
        "id": "number",
        "result": {
            "metadata": {
    
            },
            "data": {
                "columns_groups": [
                        {
                          "id": 1,
                          "name": "Посещения",
                          "description": "Показатели сессии",
                          "parent_group_id": null,
                          "sort": 100
                        },
                        {
                          "id": 2,
                          "name": "Расходы",
                          "description": "Показатели связанные с расходами на рекламу",
                          "parent_group_id": null,
                          "sort": 200
                        }
                        {
                          "id": 3,
                          "name": "Мои столбцы",
                          "description": "Пользовательские столбцы",
                          "parent_group_id": null,
                          "sort": 300
                        }
                ],
                "columns": [
                        {
                            "id": "cc_1",
                            "name": "Глубина просмотра, среднее",
                            "sort": 110,
                            "type": "metric",
                            "group_id": 1,
                            "data_type": "float",
                            "is_custom": false,
                            "expression": null,
                            "description": null,
                            "multichannel_model": null,
                            "is_transferable": false,
                            "is_pie_chart_available": false
                        },
                        {
                            "id": "cc_2",
                            "name": "Отказы, количество",
                            "sort": 111,
                            "type": "metric",
                            "group_id": 1,
                            "data_type": "integer",
                            "is_custom": false,
                            "expression": null,
                            "description": null,
                            "multichannel_model": null,
                            "is_transferable": false,
                            "is_pie_chart_available": true
                        },
                        {
                            "id": "cc_3",
                            "name": "Новые посещения, количество",
                            "sort": 112,
                            "type": "metric",
                            "group_id": 1,
                            "data_type": "integer",
                            "is_custom": false,
                            "expression": null,
                            "description": null,
                            "multichannel_model": null,
                            "is_transferable": false,
                            "is_pie_chart_available": true
                        },
                        {
                            "id": "cc_4",
                            "name": "Время на сайте, среднее",
                            "sort": 113,
                            "type": "metric",
                            "group_id": 1,
                            "data_type": "time",
                            "is_custom": false,
                            "expression": null,
                            "description": null,
                            "multichannel_model": null,
                            "is_transferable": false,
                            "is_pie_chart_available": false
                        }
                ]
            }
        }
    }
    

    Список возвращаемых ошибок

    Смотрим раздел "Список ошибок для методов с глаголом getobj"