Загрузка расходов как 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<int32>

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

Query parameters

Name

Description

comment

Type: string

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

provider

Type: string

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

Body

multipart/form-data
{
    "file": null
}

Name

Description

file*

Type: string<binary>

Responses

200 OK

OK

Body

application/json
{
    "uploading": {
        "id": 0,
        "create_time": "2022-12-29T18:02:01Z",
        "source_quantity": 0,
        "provider": "string",
        "comment": "string",
        "type": "string",
        "status": "string"
    }
}

Name

Description

uploading*

Type: ExpenseUploading

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

ExpenseUploading

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

Name

Description

comment

Type: string

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

create_time

Type: string<date-time>

Время загрузки.

id

Type: integer<int64>

Идентификатор загрузки.

provider

Type: string

Имя провайдера данных.

source_quantity

Type: integer<int32>

Количество строк в исходном файле.

status

Type: string

Статус загрузки:

  • UPLOADED — загрузка завершена.
  • IN_PROGRESS — загрузка находится в процессе обработки.
  • PROCESSED — загрузка успешно обработана.

type

Type: string

Тип загрузки:

  • EXPENSES — расходы.
  • REMOVES — удаление расходов.