---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.ru/dev/direct/doc/en/changes/checkCampaigns.md
  - https://yandex.ru/dev/direct/doc/ru/changes/checkCampaigns.md
  - href: ru/changes/checkCampaigns.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: ru/ref-v5/changes/checkCampaigns.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/direct/doc/ru/llms.txt

# checkCampaigns

Сообщает о наличии изменений в кампаниях клиента начиная с указанной даты.

### Узнайте больше {#see-also}

- [Как проверять наличие изменений](https://yandex.ru/dev/direct/doc/dg/best-practice/check-changes.html)


## Запрос {#input}

Структура запроса в формате JSON:

```javascript translate=no
{
  "method": "checkCampaigns",
  "params": { /* params */
    "Timestamp": (string) /* required */
  }
}
```

#|
|| **Параметр** | **Тип** | **Описание** | **Обязательный** ||

|| **Структура params (для JSON) / CheckCampaignsRequest (для SOAP)** | > | > | > ||

|| `Timestamp` | string | Момент времени, начиная с которого проверяются изменения. Указывается в формате `YYYY-MM-DDThh:mm:ssZ` (согласно ISO 8601), например `2015-05-24T23:59:59Z`.  | Да ||
|# 


## Ответ {#output}

Структура ответа в формате JSON:

```javascript translate=no
{
  "result": { /* result */
    "Campaigns": [{  /* CampaignChangesItem */
      "CampaignId": (long), /* required */
      "ChangesIn": [( "SELF" | "CHILDREN" | "STAT" ), ... ] /* required */
    }, ... ],
    "Timestamp": (string) /* required */
  }
}
```

#|
|| **Параметр** | **Тип** | **Описание** ||

|| **Структура result (для JSON) / CheckCampaignsResponse (для SOAP)** | > | > ||

|| `Campaigns` | array of CampaignChangesItem | Кампании, в которых произошли изменения.  ||

|| `Timestamp` | string | Момент времени, когда выполнялась проверка изменений. Выводится в формате `YYYY-MM-DDThh:mm:ssZ` (согласно ISO 8601), например `2015-05-24T23:59:59Z`. Это время указывают при следующем вызове метода, чтобы проверять изменения начиная с этого момента.  ||

|| **Структура CampaignChangesItem** | > | > ||

|| `CampaignId` | long | Идентификатор кампании.  ||

|| `ChangesIn` | array of CampaignChangesInEnum | Где именно произошли изменения:

- SELF — в параметрах кампании;
- CHILDREN — в дочерних объектах: группах, объявлениях, фразах;
- STAT — корректировка статистики кампании (как правило, в связи с фильтрацией недобросовестных кликов).  ||
|# 


## Примеры {#samples}

**Проверка наличия изменений в кампаниях, начиная с 02.02.2015 10:08:22 UTC**
 
```javascript translate=no
    {
      "method": "checkCampaigns",
      "params": {
        "Timestamp": "2015-02-02T10:08:22Z"
      }
    }
```

**Ответ**
 
```javascript translate=no
    {
      "result": {
        "Campaigns": [{
          "CampaignId": 13243,
          "ChangesIn": ["SELF"]
        },
        {
          "CampaignId": 13326,
          "ChangesIn": ["SELF","CHILDREN"]
        },
        {
          "CampaignId": 14742,
          "ChangesIn": ["CHILDREN"]
        }],
        "Timestamp": "2015-02-02T12:24:31Z"
      }
    }
```

Произошли изменения в трех кампаниях: в двух изменились параметры кампании и в двух — дочерние объекты.