Использование Yandex Translate (Яндекс.Переводчик)

24.09.21

Интеграция - WEB-интеграция

–

В статье опишу вариант подключения и использования Yandex Translate.

Скачать исходный код

	Наименование	Файл	Версия	Размер
	Yandex Translate Cloud.postman_collection .json 2,47Kb 50	.json		2,47Kb	50	Скачать бесплатно

Вводные

1. Конфигурация УТ 11.4

2. Нужно сделать перевод 10+ тыс. строк (наименования товаров).

Реализация

Использовал HTTP API от Yandex Translate, потомок Яндекс.Переводчик (ссылка).

Стоимость использования Yandex Translate рассчитывается, исходя из суммарного количества символов (ссылка).

Является частью группы услуг "AI API".

Схема аккаунтов в Яндекс.Облако:

Регистрация

Для начала работ нужно иметь аккаунт Яндекса. Перейти в https://console.cloud.yandex.ru/.

Создать платежный аккаунт с привязкой к банковской карте, без этого сервисный аккаунт не создается. Создается на странице https://console.cloud.yandex.ru/billing

скриншот

По умолчанию присутствует каталог "default", скопировать его идентификатор и перейти в него.

скриншот

В рамках каталога создать сервисный аккаунт с присвоением ему роли editor

скриншоты

После добавления перейти в профиль сервисного пользователя

скриншот

Создать API ключ и получить секретный ключ.

скриншоты

Использование сервиса

Документация

Используется метод POST, основной адрес https://translate.api.cloud.yandex.net/translate/v2/translate, формат данных JSON.

При использовании сервисного аккаунта используется аутентификация с через заголовок "Authorization: Api-Key <API-ключ>" (ссылка, вкладка Сервисный аккаунт). В теле запроса указывается id каталога.

скриншот запроса

Реализация в 1С

Общий модуль

Функция ПолучитьПеревод(СтрокаВх) Экспорт


   НастройкиПодсистемы = на_ВызовСервера.ПолучитьНастройкиПодсистемы();

   МассивТекстов = Новый Массив;
   МассивТекстов.Добавить(СтрокаВх);

   СоответствиеДанные = Новый Соответствие;
   СоответствиеДанные.Вставить("folder_id", НастройкиПодсистемы.ИдентификаторКаталогаЯндексОблако);
   СоответствиеДанные.Вставить("texts", МассивТекстов);
   СоответствиеДанные.Вставить("sourceLanguageCode", "en");
   СоответствиеДанные.Вставить("targetLanguageCode", "ru");

   СтрокаДанные = ос_ОбработкаДанных.В_JSON(СоответствиеДанные);

   Ответ = POST("/translate/v2/translate", СтрокаДанные, НастройкиПодсистемы);

   Если Ответ.КодСостояния = 200 Тогда

       СтрокаОтвет = Ответ.ПолучитьТелоКакСтроку();
       СоответствиеОтвет = ос_ОбработкаДанных.ИЗ_JSON(СтрокаОтвет);

       МассивПереводов = СоответствиеОтвет.Получить("translations");

       Перевод = МассивПереводов[0].Получить("text");

       Возврат Перевод;

   Иначе
       Возврат "";
   КонецЕсли;

КонецФункции

Функция POST(АдресРесурса, СтрокаДанные, КлючСервисногоПользователяЯндексОблако)

   HTTPСтруктура = ПолучитьHTTPСтруктура(АдресРесурса, КлючСервисногоПользователяЯндексОблако);

   HTTPЗапрос = HTTPСтруктура.HTTPЗапрос;
   HTTPСоединение = HTTPСтруктура.HTTPСоединение;

   HTTPЗапрос.УстановитьТелоИзСтроки(СтрокаДанные,,);

   Попытка

       HTTPОтвет = HTTPСоединение.ВызватьHTTPМетод("POST", HTTPЗапрос);

   Исключение
       СообщитьОбОшибке(ОписаниеОшибки());
       Отказ = Истина;
       HTTPОтвет = Новый Структура;
       HTTPОтвет.Вставить("КодСостояния", 500);
   КонецПопытки;

   ПроверитьНаКодыОшибок(HTTPОтвет, "POST " + АдресРесурса);

   Возврат HTTPОтвет;

КонецФункции

Процедура ПроверитьНаКодыОшибок(HTTPОтвет, ОписаниеЗапроса)

   КодСостояния = HTTPОтвет.КодСостояния;

   Если КодСостояния = 301
       ИЛИ КодСостояния = 302
       ИЛИ КодСостояния = 501
       ИЛИ КодСостояния = 401
       ИЛИ КодСостояния = 500
       Тогда

       СообщитьОбОшибке(ОписаниеЗапроса + Символы.ПС + "КодСостояния: " + КодСостояния);

       Отказ = Истина;

   ИначеЕсли КодСостояния = 400
       ИЛИ КодСостояния = 404
       Тогда

       СообщитьОбОшибке(ОписаниеЗапроса + Символы.ПС + "КодСостояния: " + КодСостояния);


   КонецЕсли;

КонецПроцедуры

Функция ПолучитьHTTPСтруктура(АдресРесурса, НастройкиПодсистемы)

   Отказ = Ложь;

   Заголовки = Новый Соответствие;
   Заголовки.Вставить("Authorization", "Api-Key " + НастройкиПодсистемы.КлючСервисногоПользователяЯндексОблако);

   Сервер = "translate.api.cloud.yandex.net";
   ssl4 = Новый ЗащищенноеСоединениеOpenSSL(Неопределено, Неопределено);
   HTTPСоединение = Новый HTTPСоединение(Сервер,,,,,,ssl4);


   HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, Заголовки);

   HTTPСтруктура = Новый Структура;
   HTTPСтруктура.Вставить("HTTPСоединение", HTTPСоединение);
   HTTPСтруктура.Вставить("HTTPЗапрос", HTTPЗапрос);

   Возврат HTTPСтруктура;

КонецФункции

Процедура СообщитьОбОшибке(Комментарий, Уровень = "", Данные = Неопределено) Экспорт

   Если Уровень = "" Тогда

       Уровень = УровеньЖурналаРегистрации.Ошибка;

   КонецЕсли;

   ЗаписьЖурналаРегистрации("Yandex Translate",,,,Комментарий);

   Сообщение = Новый СообщениеПользователю;
   Сообщение.Текст = "" + Комментарий;
   Сообщение.Сообщить();

КонецПроцедуры

UPD 2021_09_24: Добавил коллекцию Postman для более удобного тестирования, перед использованием нужно зайти в настройки коллекции и заполнить variables "api_key" и "folder_id"

Итог

Сервис перевода текста подключается относительно просто. Качество перевода хорошее.

Благодарю за внимание.

Переводчик Translate Яндекс Yandex

–

См. также

Интеграция Альфа Авто 5 / Альфа Авто 6 и AUTOCRM / Инфотек

Сайты и интернет-магазины WEB-интеграция Платформа 1С v8.3 Конфигурации 1cv8 1С:Управление торговлей 11 Автомобили, автосервисы Россия Управленческий учет Платные (руб)

Интеграционный модуль обмена между конфигурацией Альфа Авто 5 и Альфа Авто 6 и порталом AUTOCRM. Данный модуль универсален. Позволяет работать с несколькими обменами AUTOCRM разных брендов в одной информационной базе в ручном и автоматическом режиме.

36000 руб.

03.08.2020 15930 13 18

Управление доставками Boxberry, СДЭК, ЭкстраПочта, Почта России, Энергия, DPD, ПЭК, Grastin, Деловые Линии, КСЕ, Dalli

WEB-интеграция Рабочее место Оптовая торговля Розничная торговля Логистика, склад и ТМЦ Платформа 1С v8.3 1С:Бухгалтерия 2.0 1С:Управление торговлей 10 1С:Розница 2 1С:Управление нашей фирмой 1.6 1С:Бухгалтерия 3.0 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х Оптовая торговля, дистрибуция, логистика Россия Управленческий учет Платные (руб)

Управление доставками в транспортных компаниях из 1С.

18000 руб.

10.03.2016 56737 287 97

Все службы доставки в Вашей 1С! Без изменения конфигурации! УТ, ERP, КА, УНФ

WEB-интеграция Рабочее место Оптовая торговля Розничная торговля Логистика, склад и ТМЦ Платформа 1С v8.3 1С:ERP Управление предприятием 2 1С:Управление торговлей 11 Россия Управленческий учет Платные (руб)

40+ служб доставки для 1С в одном модуле! Внешняя обработка, которая НЕ изменяет Вашу конфигурацию! Подписная модель на 1 год.

19200 руб.

22.03.2017 36445 16 47

Интеграция с OpenCart 2.x, 3x

WEB-интеграция Оптовая торговля Розничная торговля Управляемые формы 1С:Розница 2 1С:Управление нашей фирмой 1.6 1С:Бухгалтерия 3.0 1С:Управление торговлей 11 Розничная и сетевая торговля (FMCG) Оптовая торговля, дистрибуция, логистика Управленческий учет Платные (руб)

Внешняя обработка, позволяет обмениваться данными между OpenCart (самая популярная бесплатная cms для интернет-магазинов) и 1С:Предприятие 8.

6800 руб.

17.11.2015 115874 344 137

213

Интеграция 1С — Битрикс24. Обмен задачами

Сайты и интернет-магазины Интеграция WEB-интеграция Платформа 1С v8.3 Конфигурации 1cv8 Управленческий учет Платные (руб)

Интеграция 1С и Битрикс24. Разработка имеет двухстороннюю синхронизацию 1С и Битрикс24 задачами. Решение позволяет создавать пользователя в 1С из Битрикс24 и наоборот. Данная разработка технически подходит под все основные конфигурации линейки продуктов 1С:Предприятие 8.3 (8.3.18.1289). При приобретении предоставляется 1 месяц бесплатных обновлений разработки. Доступна демо-версия продукта с подключением Вашего Битрикс24

5040 руб.

04.05.2021 17880 6 15

Заполнение по ИНН или наименованию реквизитов контрагента по данным сайта ФНС

Обмен с ГосИС WEB-интеграция Платформа 1С v8.3 Управляемые формы 1С:Комплексная автоматизация 1.х 1С:Бухгалтерия 2.0 1С:Управление торговлей 10 1С:Управление производственным предприятием 1С:Управление нашей фирмой 1.6 1С:Бухгалтерия государственного учреждения 1С:Документооборот 1С:ERP Управление предприятием 2 1С:Бухгалтерия 3.0 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х Платные (руб)

Обработка является альтернативой механизму, разработанному фирмой 1С и заполняющему реквизиты контрагента по ИНН или наименованию. Не требуется действующей подписки ИТС. Вызывается как внешняя дополнительная обработка, т.е. используется, непосредственно, из карточки контрагента. Заполнение по ИНН или наименованию реквизитов контрагента по данным сайта ФНС (egrul.nalog.ru) для БП 2.0, БП 3.0, БГУ 1.0, БГУ 2.0, УТ 10.3, УТ 11.x, КА 1.1, КА 2.x, УПП 1.x, ERP 2.x, УНФ 1.5, УНФ 1.6, УНФ 3.0, ДО 2.1

2400 руб.

28.04.2016 88926 163 216

318

[Расширение] БОР-Навигатор.Культура

Зарплата Бюджетный учет WEB-интеграция Обмен с ГосИС Платформа 1С v8.3 Сложные периодические расчеты 1С:Зарплата и кадры государственного учреждения 3 Государственные, бюджетные структуры Россия Бюджетный учет Платные (руб)

Расширение конфигурации, включающее в себя объекты, необходимые для подготовки и сдачи отчета "Штатная численность" системы "БОР-Навигатор.Культура" в программе "1С:Зарплата и кадры государственного учреждения", редакция 3.1.

8400 руб.

01.02.2019 25871 9 0

Интеграция с сервисом vetmanager

WEB-интеграция Платформа 1С v8.3 Бухгалтерский учет 1С:Бухгалтерия 3.0 Бытовые услуги, сервис Платные (руб)

Внешняя обработка разрабатывалась для загрузки документов из Ветменеджер в 1С: Бухгалтерия 3.0

12000 руб.

02.02.2021 16477 42 49

Комментарии

Подписаться на ответы Инфостарт бот

Свернуть все

1. rabid_otter 134 08.07.20 09:05 Сейчас в теме

интересно. а гугл транслейт никак? он вроде бы платный.

2. malikov_pro 1293 08.07.20 09:30 Сейчас в теме

(1) Документация на английском, что менее удобно в использовании (ссылка), стоимость выше (ссылка)

3. user953800 08.07.20 10:08 Сейчас в теме

(1) Использую код этой обработки, идёт обращение к мобильной версии сайта и парсинг html. Бесплатно.
Подозреваю, что тут нечто похожее с предыдущей обработкой.

4. malikov_pro 1293 08.07.20 10:30 Сейчас в теме

(3) Тема с парсингом известна, но HTML версия для личного использования, API для коммерческого. На перевод 18к строк ушло 250 руб., что для клиента приемлемо. "Каждый выбирает для себя".

5. user797130 15.07.20 14:14 Сейчас в теме

Идентификатор ключа и секретный ключ на скриншоте не лишние, случайно?

6. malikov_pro 1293 15.07.20 15:30 Сейчас в теме

(5) тестовые, удалены уже.

7. AlexanderBN 06.11.20 17:00 Сейчас в теме

Где описание процедуры "ос_ОбработкаДанных.В_JSON"
и "ос_ОбработкаДанных.ИЗ_JSON"
?

8. malikov_pro 1293 06.11.20 17:24 Сейчас в теме

(7)
https://github.com/vbondarevsky/Connector/blob/master/src/CommonModules/%D0%9A%D0%BE%D0%BD%D0%BD%D0%B5%D0%BA%D1%82%D0%BE%D1%80HTTP/Ext/Module.bsl
Функции JsonВОбъект() и ОбъектВJson()

9. biker 15.07.23 11:25 Сейчас в теме

подниму тему, понадобилось сделать перевод наименований товаров, 20к строк, решил заморочиться через яндекс API, зарегистрировался в яндекс cloud, мне еще предложили грант 4000 рублей на 60 дней, создал сервисный аккаунт, создал ключ API, пробую переводить при помощи вашей обработки, единственное, функции кодирования в json строку я взял в другом месте, в итоге тело запроса у меня выглядит так:
{
"sourceLanguageCode": "ru",
"targetLanguageCode": "en",
"texts": [
"проверка перевода"
]
}
сначала был еще folder_id, потом я его убрал (согласно документации если используется API ключ параметр folder_id передавать не надо), на результат никак не влияет, в итоге получаю ошибку 400, и непонятное тело ответа:
Expected a value.
{
"sourceLangua
^

техподдержка яндекса пока ничем не помогла, отсылает читать документацию, пробовал через postman повторить, результат тот же.

11. malikov_pro 1293 19.07.23 07:43 Сейчас в теме

(9) ответил в (10)

10. malikov_pro 1293 19.07.23 07:41 Сейчас в теме

(9) "сначала был еще folder_id, потом я его убрал (согласно документации если используется API ключ параметр folder_id передавать не надо),"

https://cloud.yandex.ru/docs/translate/quickstart
"folderId — идентификатор каталога, полученный перед началом работы." - это директория приложений Я-Облако, в рамках него через IAM токен получаете доступ к функционалу