Запрос на экспорт сегмента

Создайте запрос на выгрузку сегмента в CSV-файлы.

Выгружать сегменты могут только владельцы аккаунта и те пользователи, которым выдано разрешение на выгрузку. Подробнее см. раздел Управление пользователями.

Входные данные

POST https://tracker.my.com/api/segment/v1/export/create.json

Параметры

* — обязательные параметры

Описание идентификаторов

Таблица содержит описание идентификаторов, которые можно выгрузить с помощью параметра requestFields.

Пример запроса

Выгрузка идентификаторов gaid и idfaпо сегменту с id=1:

/api/segment/v1/export/create.json?idSegment=1&requestFields=gaid,idfa

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

В случае успеха

Если запрос создан успешно, вы получите код ответа 200. Идентификатор запроса будет указан в поле idSegmentExport:

{
  "code": 200,
  "message": "Ok",
  "data": {
    "idSegmentExport": "1"
  }
}

Ошибки

При ошибках в передаваемых параметрах вы получите код ответа 400. Например:

• Запрос недоступного или несуществующего сегмента (idSegment)

  {
    "code": 400,
    "message": "Bad Request",
    "data": {
      "error": {
        "detail": "Argument 'idSegment' is invalid"
      }
    }
  }

Ограничения

• Данный метод требует авторизации. Вы получите код ответа 403, если сделаете запрос с невалидной авторизацией или не передадите её совсем.

  {
    "code": 403,
    "message": "Access denied",
    "data": null
  }

• Количество одновременно выполняемых запросов ограничено. При превышении допустимого числа запросов вы получите код ответа 400:

  {
    "code": 400,
    "message": "Bad Request",
    "data": {
      "error": {
        "detail": "Maximum number of simultaneous requests reached. Wait until there is space available in the queue.",
        "info": {
          "exports": [
            {
              "idSegmentExport": "1"
            }
          ]
        }
      }
    }
  }

• Выгрузка сегмента, который уже находится в процессе выгрузки невозможна:

  {
    "code": 400,
    "message": "Bad Request",
    "data": {
      "error": {
        "detail": "This segment is already being exported"
      }
    }
  }