Жарнамалық науқанның мәртебесі

кампания/статус

Параметрлер:

• token – авторизация (жол)
• id – жарнамалық науқанның идентификаторы (int )
  ids – жарнамалық науқан идентификаторларының үтірмен бөлінген тізімі (string , мысалы: "100001, 100002, 10003")
  Жарнама науқанының бір ғана ID-сін (id) немесе ID-лер тізімін (ids) көрсете аласыз. Егер осы параметрлердің ешқайсысы берілмесе, жарнама науқандарының толық тізімі қайтарылады.
• status – жарнама науқанының мәртебесі (өрнек, әдепкі: барлық жарнама науқандары). Мәндері:
  • rejected – модератор тарапынан блокталған
  • модерацияда – модерацияны күтуде
  • тоқтатылды – науқан тоқтатылды
  • active – науқан белсенді
  • белсенді емес – науқан белсенді емес (есептік жазбада көрсетілімдері жоқ)
• валюта – валюта (өрнек, әдепкі: есептік валюта). Мәнділері:
  • руб
  • usd
• language – жарнамалық науқан сипаттамасының тілі (өрнек, әдепкі: есептік жазба тілі). Мәнділері:
  • ru – орысша
  • en – ағылшын
  • es – испанша
  • pt – португалша

Жарнама науқандарының санына шектеу: 1 000. Жарнама науқандарының толық тізімін алу үшін келесі параметрді пайдаланыңыз:

• pagination_skip – offset, өткізіп жіберуге тиісті жарнама науқандарының саны (int)

Әдісті шақырудың мысалы:

<?php
    $post = array(
        'token' => $token,
        'id' => 999999
    );
    if ($curl = curl_init()) {
        curl_setopt($curl, CURLOPT_URL, 'https://www.ipweb.ru/api/v2/campaign/status');
        curl_setopt($curl, CURLOPT_RETURNTRANSFER,true);
        curl_setopt($curl, CURLOPT_POST, true);
        curl_setopt($curl, CURLOPT_POSTFIELDS, $post);
        $out = curl_exec($curl);
        echo $out;
        curl_close($curl);
    }

// Результат:

{
    "id": 999999,
    "balance_actions": 2,
    "actions_hour": 0,
    "actions_today": 0,
    "actions_month": 0,
    "actions_all": 12,
    "status": "stopped",
    "one_action_cost": 0.786,
    "one_action_currency": "₽",
    "one_action_currency_iso": "RUB"
}

====================================================================================

<?php
    $post = array(
        'token' => $token
    );
    if ($curl = curl_init()) {
        curl_setopt($curl, CURLOPT_URL, 'https://www.ipweb.ru/api/v2/campaign/status');
        curl_setopt($curl, CURLOPT_RETURNTRANSFER,true);
        curl_setopt($curl, CURLOPT_POST, true);
        curl_setopt($curl, CURLOPT_POSTFIELDS, $post);
        $out = curl_exec($curl);
        echo $out;
        curl_close($curl);
    }

// Результат:

{
    "campaigns": [
        {
            "id": 999999,
            "balance_actions": 2,
            "actions_hour": 0,
            "actions_today": 0,
            "actions_month": 0,
            "actions_all": 12,
            "status": "stopped",
            "one_action_cost": 0.786,
            "one_action_currency": "₽",
            "one_action_currency_iso": "RUB"
        },
        {
            "id": 999999,
            "balance_actions": 2,
            "actions_hour": 0,
            "actions_today": 0,
            "actions_month": 0,
            "actions_all": 12,
            "status": "stopped",
            "one_action_cost": 0.786,
            "one_action_currency": "₽",
            "one_action_currency_iso": "RUB"
        }
    ],
    "error_code": 0
}

«status» өрісінің мүмкін мәндері:

• rejected – модератор тарапынан блокталған.
• moderating – модерация күтілуде.
• тоқтатылды – науқан тоқтатылды.
• active – науқан белсенді.
• белсенді емес – науқан белсенді емес (оның есепшотында ешқандай көрсетілім жоқ).