Загрузка расходов как multipart/form-data

Выполняет загрузку расходов.

Важно

Данные Директа загружать не нужно — они передаются в Метрику автоматически. Если вы загрузите данные в файле, они будут дублироваться с переданными автоматически — отчет станет некорректным.

Данные передаются как multipart/form-data в параметре file, в формате CSV. В первой строке запроса необходимо передать названия колонок.

Обязательные колонки:

Date — строка, дата в формате YYYY-MM-DD или диапазон дат в формате YYYY-MM-DD/YYYY-MM-DD.
UTMSource — строка, значение метки utm_source. Необязательна, если передается TrafficSource.
TrafficSource — источник трафика первого уровня. Доступные значения описаны в таблице.
Expenses — число, сумма расходов, десятичным разделителем является точка.

Необязательные колонки:

TrafficSourceDetail — источник трафика второго уровня. Доступные значения описаны в таблице.
UTMMedium — строка, значение метки utm_medium.
UTMCampaign — строка, значение метки utm_campaign.
UTMTerm — строка, значение метки utm_term.
UTMContent — строка, значение метки utm_content.
Currency — строка, трехбуквенный код валюты по ISO 4217.
Clicks — число, количество кликов.

Примечание

Значения UTM-меток регистрозависимые. Это важно учесть при загрузке и удалении данных.

Request

POST

https://api-metrika.yandex.net/management/v1/counter/{counterId}/expense/upload

Path parameters

Name

Description

counterId

Type: integer

Идентификатор счетчика, для которого вы хотите загрузить расходы.

Query parameters

Name

Description

comment

Type: string

Комментарий.

Example: ``

provider

Type: string

Сервис, который передает данные в Метрику (провайдер). Если не указано, используется значение default.

Example: ``

Body

multipart/form-data

{
  "file": "example"
}

Name

Description

file

Type: string<binary>

Example: example

Responses

200 OK

Body

application/json

{
  "uploading": {
    "id": 0,
    "create_time": "2025-01-01T00:00:00Z",
    "source_quantity": 0,
    "provider": "example",
    "comment": "example",
    "type": "example",
    "status": "example"
  }
}

Name

Description

uploading

Type: ExpenseUploading

Информация о загрузке расходов.

Example

{
  "id": 0,
  "create_time": "2025-01-01T00:00:00Z",
  "source_quantity": 0,
  "provider": "example",
  "comment": "example",
  "type": "example",
  "status": "example"
}

ExpenseUploading

Информация о загрузке расходов.

Name	Description
comment	Type: string Комментарий. Example: `example`
create_time	Type: string<date-time> Время загрузки. Example: `2025-01-01T00:00:00Z`
id	Type: integer Идентификатор загрузки.
provider	Type: string Имя провайдера данных. Example: `example`
source_quantity	Type: integer Количество строк в исходном файле.
status	Type: string Статус загрузки: `UPLOADED` — загрузка завершена. `IN_PROGRESS` — загрузка находится в процессе обработки. `PROCESSED` — загрузка успешно обработана. Example: `example`
type	Type: string Тип загрузки: `EXPENSES` — расходы. `REMOVES` — удаление расходов. Example: `example`

Example

{
  "id": 0,
  "create_time": "2025-01-01T00:00:00Z",
  "source_quantity": 0,
  "provider": "example",
  "comment": "example",
  "type": "example",
  "status": "example"
}

Была ли статья полезна?

Введение

Удаление данных о расходах в запросе