Редактировать обучение
PUT /trainings/{id}
Вносит изменения в обучающий пул.
В теле запроса укажите все параметры обновляемого обучающего пула. Идентификатор обучающего пула можно узнать из списка обучающих пулов.
Примечание
О редактировании обычного пула читайте в разделе Редактировать пул.
Примеры запросов
curl -X PUT 'https://tasks.yandex.ru/api/v1/trainings/1239110' \
-H 'Authorization: OAuth PlaceYourRealOAuthToken_Here' \
-H 'Content-Type: application/json' \
-d '{"project_id":"118252", "private_name":"Simple training pool", "may_contain_adult_content":false, "assignment_max_duration_seconds":600, "mix_tasks_in_creation_order":true, "shuffle_tasks_in_task_suite":true, "training_tasks_in_task_suite_count":3, "task_suites_required_to_pass":1, "retry_training_after_days":1, "inherited_instructions":true, "public_instructions":""}'
import requests
url = "https://tasks.yandex.ru/api/v1/trainings/1239110"
headers = {
'Authorization': 'OAuth PlaceYourRealOAuthToken_Here',
'Content-Type': 'application/json'
}
payload = {
"project_id": "118252",
"private_name": "Simple training pool",
"may_contain_adult_content": False,
"assignment_max_duration_seconds": 600,
"mix_tasks_in_creation_order": True,
"shuffle_tasks_in_task_suite": True,
"training_tasks_in_task_suite_count": 3,
"task_suites_required_to_pass": 1,
"retry_training_after_days": 1,
"inherited_instructions": True,
"public_instructions": ""
}
response = requests.put(url, headers=headers, json=payload)
print(response.text)
var request = require('request');
var options = {
'method': 'PUT',
'url': 'https://tasks.yandex.ru/api/v1/trainings/1239110',
'qs': {},
'headers': {
'Authorization': 'OAuth PlaceYourRealOAuthToken_Here',
'Content-Type': 'application/json'
},
'body': JSON.stringify({
"project_id": "118252",
"private_name": "Simple training pool",
"may_contain_adult_content": false,
"assignment_max_duration_seconds": 600,
"mix_tasks_in_creation_order": true,
"shuffle_tasks_in_task_suite": true,
"training_tasks_in_task_suite_count": 3,
"task_suites_required_to_pass": 1,
"retry_training_after_days": 1,
"inherited_instructions": true,
"public_instructions": ""
})
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Path-параметры
Параметр |
Описание |
|
string Идентификатор обучающего пула. |
Заголовки
Заголовок |
Описание |
|
API-токен для авторизации аккаунта. В качестве префикса добавьте |
|
Указывает формат данных ( |
Тело и параметры запроса
В теле запроса укажите все параметры обучения, включая обновляемые.
Ответ
Содержит сведения об измененном обучающем пуле.
Пример ответа
{
"id": "31226418",
"project_id": "74175",
"private_name": "Simple training pool",
"inherited_instructions": true,
"public_instructions": "",
"may_contain_adult_content": false,
"assignment_max_duration_seconds": 600,
"mix_tasks_in_creation_order": true,
"shuffle_tasks_in_task_suite": true,
"training_tasks_in_task_suite_count": 10,
"retry_training_after_days": 14,
"owner": {
"id": "6c6e20dc86cca2ae787afcb2629de162",
"myself": true
},
"status": "OPEN",
"last_close_reason": "MANUAL",
"created": "2022-01-22T07:50:14.781",
"last_started": "2022-01-22T07:50:21.491",
"last_stopped": "2022-02-24T13:40:29.754"
}
Включает:
-
параметры, которые используются при создании обучающего пула:
Параметр
Описание
project_id
*string
Идентификатор проекта, для которого создан обучающий пул.
private_name
*string
Название обучающего пула (доступно только заказчику).
inherited_instructions
*boolean
Указывает, использовать ли инструкцию проекта. Если для обучения нужна своя инструкция, то укажите ее в
public_instructions
.По умолчанию значение
false
.public_instructions
string
Инструкция по выполнению обучающих заданий. Можно использовать любую HTML-разметку.
may_contain_adult_content
boolean
Присутствие контента для взрослых в заданиях.
assignment_max_duration_seconds
integer
Время на выполнение страницы заданий в секундах. Рекомендуется выделять на страницу заданий не менее 60 секунд (с учетом времени на загрузку страницы и отправку ответов). Минимум — 5, максимум — 2 147 483 647 секунд.
mix_tasks_in_creation_order
boolean
Выдаются ли обучающие задания в порядке загрузки:
true
— для формирования страниц задания берутся по порядку строк (сверху вниз) из загруженного файла;false
— задания будут браться в случайном порядке.
По умолчанию значение
true
.shuffle_tasks_in_task_suite
boolean
Перемешиваются ли обучающие задания внутри каждой страницы:
true
— да;false
— нет, они будут располагаться в том порядке, в каком были загружены.
По умолчанию значение
true
.training_tasks_in_task_suite_count
*integer
Количество обучающих заданий на одной странице. Минимум — 0, максимум — 500.
task_suites_required_to_pass
integer
Количество страниц, которые нужно успешно выполнить для назначения навыка и допуска к боевым заданиям. Минимум — 0, максимум — 500.
retry_training_after_days
integer
Через сколько дней станет доступно повторное прохождение. Минимум — 1, максимум — 500.
-
параметры, которые присваиваются автоматически:
Параметр
Описание
id
string
Идентификатор обучающего пула.
owner.id
string
Идентификатор заказчика.
owner.myself
boolean
Проверяет, кому принадлежит объект:
true
— пользователю, который совершил запрос;false
— другому аккаунту (сотруднику или владельцу).
status
string
Статус обучающего пула:
OPEN
— открыт;CLOSED
— закрыт;ARCHIVED
— архивный.
last_close_reason
string
Причина предыдущего закрытия обучающего пула:
MANUAL
— обучение закрыто клиентом;EXPIRED
— наступило время, указанное в параметреwill_expire
;COMPLETED
— закрыто автоматически по завершению всех заданий;NOT_ENOUGH_BALANCE
— закрыто автоматически, поскольку на аккаунте закончились средства;ASSIGNMENTS_LIMIT_EXCEEDED
— закрыто автоматически из-за превышения лимита выданных страниц заданий (максимально 2 миллиона);BLOCKED
— закрыто автоматически из-за блокировки аккаунта клиента администрацией платформы;FOR_UPDATE
— закрыто для редактирования.
created
string
Дата и время создания обучающего пула по UTC в формате ISO 8601:
YYYY-MM-DDThh:mm:ss[.sss]
.last_started
string
Дата и время последнего запуска обучающего пула по UTC в формате ISO 8601:
YYYY-MM-DDThh:mm:ss[.sss]
.last_stopped
string
Дата и время последней остановки обучающего пула по UTC в формате ISO 8601:
YYYY-MM-DDThh:mm:ss[.sss]
.
Обязательный параметр