Šajā rakstā ir Masveida tulkotāja modulis un tā atslēga: kur modulis panelī atrodas, kādas tam ir cilnes, kā iegūt DeepL, Google Translate vai Microsoft (Azure) API atslēgu, kur to panelī ievada un kā pārbaudīt, ka tā tiešām strādā.
Ar ko Masveida tulkotājs atšķiras no Integrāciju centrāles tulkošanas rāmja un kā svešvalodas aprakstus padarīt lasāmus bez atslēgas — [Mašīntulkošana — divi veidi un lauks «Avota valoda»](/hc/help2/articles/ecomlink-masintulkosana). Kā ar gatavu atslēgu palaist pašu tulkošanu un cik tā maksā — [Masveida tulkošanas palaišana, izmaksas un atcelšana](/hc/help2/articles/ecomlink-masveida-tulkosanas-palaisana).

## Kur EcomCart tiešām prasa tulkotāja API atslēgu

API atslēgu prasa **Masveida tulkotājs** — atsevišķs modulis, kas nav Integrāciju centrāles daļa. Tas tulko ne
tikai Integrāciju centrāles atnestās preces, bet arī kategorijas, atribūtus, opcijas, filtrus un informācijas
lapas.

**Kā tur nokļūt:** kreisā izvēlne → **Rīki** → **Masveida tulkotājs**. Punkts izvēlnē parādās
lietotājam, kuram grupā ir atļauta piekļuve šim modulim.

Panelī šis modulis parādās ar trim rakstībām — izvēlnē **Masveida tulkotājs**, lapas virsrakstā
**Masu Tulkotājs**, cilnē **Masuveida tulkotājs**. Tā ir viena un tā pati vieta.

> 📷 **Ekrānattēls:** kreisā izvēlne — sadaļa «Rīki» ar punktu «Masveida tulkotājs»

⚠️ **Modulis ir pieejams no PRO plāna.** Zemākā plānā ekrāna vietā tiek rādīts paskaidrojums un
paziņojums *«Funkcija pieejama EcomCart PRO un augstākos plānos. Uzlabojiet plānu klientu
portālā.»* ar pogu **Uzlabot plānu**.

Modulim ir šādas cilnes (pirmā, kas atveras, ir **Testa tulkotājs**):

- **Testa tulkotājs** — vieta, kur pārbaudīt, vai atslēga strādā. Sk. sadaļu
  «Kā pārbaudīt, vai atslēga strādā».
- **Masuveida tulkotājs** — galvenais darba ekrāns, kur palaiž pašu masveida tulkošanu. Sk. rakstu
  [Masveida tulkošanas palaišana, izmaksas un atcelšana](/hc/help2/articles/ecomlink-masveida-tulkosanas-palaisana).
- **Automātiskā tulkošana** — tulko tukšos laukus brīdī, kad saglabājat preci, kategoriju vai
  informācijas lapu. Tieši šajā cilnē atzīmē arī to, **kurus laukus tulkot** (nosaukums, apraksts,
  meta virsraksts, meta apraksts, meta atslēgvārdi, SEO H1, attēlu nosaukumi u.c.), un šo pašu
  izvēli izmanto masveida palaišana. Cilnē **Masuveida tulkotājs** sadaļā **Tulkojamie lauki** tas
  ir arī tieši pateikts: *«Izvēlieties, kurus laukus tulkot, sadaļā Automātiskā tulkošana >
  Rediģēt»*. Ķeksīšu tabulai ir divas ailes — **Izveidot** (jauna vienuma veidošana) un **Labot**
  (esoša vienuma labošana). Masveida palaišana izmanto **Labot** aili; tieši to paskaidrojums sauc
  par «Rediģēt». Ja tajā ailē nekas nav atzīmēts, masveida palaišana nostrādā tukšā.
- **Žurnāls** — slēdzis **Atkļūdošanas režīms** (**ATSPĒJOTS — nereģistrēt tulkojumus** /
  **IESPĒJOTS — žurnālu tulkojumi**) un teksta logs ar pogām **Atsvaidzināt žurnālus**,
  **Saglabāt žurnāla failu** un **Notīrīt žurnālus**. ⚠️ Teksta logs paliek **tukšs** arī ar
  ieslēgtu slēdzi: EcomCart tulkošanas ierakstus glabā servera pusē un panelī tos nerāda. Tāpēc
  masveida palaišanas rezultātu meklējiet pašās precēs, nevis šajā cilnē.
- **Iestatījumi** — pakalpojuma izvēle, API atslēga un pārējie moduļa iestatījumi.
- **Instrukcijas** — īss paskaidrojums un saites uz visu atbalstīto pakalpojumu sniedzēju vietnēm.

Cilne **Cron** ir redzama tikai sistēmas administratoru grupai.

> 📷 **Ekrānattēls:** extension/module/mass_translate — cilne «Automātiskā tulkošana», lauku tabula ar ķeksīšiem

### Kur ieliek atslēgu

Atslēgu ievada cilnē **Iestatījumi**:

1. Izvēlnē **Atlasiet tulkošanas API** izvēlas pakalpojumu. Izvēlnē ir visi atbalstītie
   pakalpojumi, un tie ir attēloti ar saviem logotipiem. Jaunā veikalā sākotnēji nav izvēlēts
   neviens, un tad neviens atslēgas lauks vēl nav redzams — lauki parādās tikai pēc tam, kad
   pakalpojums ir izvēlēts.
2. Zemāk parādās tieši tā pakalpojuma lauki: vispirms pakalpojuma logotips, un tad lielākajai
   daļai pakalpojumu — lauks **API atslēga** (izņēmumus sk. tabulā zemāk).
3. Nospiež **Saglabāt** (poga ekrāna augšējā labajā stūrī).

Pakalpojumu izvēlieties **pirms** ejat pēc atslēgas: atslēga der tikai tam pakalpojumam, kuram tā
izsniegta, un DeepL vai Google konta izveide aizņem labu pusstundu.

> 📷 **Ekrānattēls:** extension/module/mass_translate — cilne «Iestatījumi», izvēle «Atlasiet tulkošanas API» un zem tās lauks «API atslēga»

Kuriem pakalpojumiem kādi lauki ir papildus:

| Pakalpojums izvēlnē | Papildu lauki bez «API atslēgas» |
|---|---|
| **Deepl** | **API galapunkts** (izvēle no divām adresēm) un **Glosārijs** |
| **Google Translate API** | **Tulkošanas dzinējs** — «Bāze — pamata tulkošanas dzinējs» vai «Neironu mašīntulkošana — uzlabots AI tulkošanas dzinējs» |
| **Microsoft Translator** | **API reģions** |
| **OpenAI ChatGTP** | **AI modelis** |
| **Rapid API**, **Yandex Translate**, **Lingvanex Cloud API** | tikai atslēga |
| **Systran**, **IBM Watson Translator** | lauku nav — arī atslēgas lauka nav; to vietā stāv paziņojums, ka integrācija vēl top |

Turpat cilnē ir arī **Ignorēt/aizstāt sarakstu** (vārdi, ko netulkot vai aizstāt ar noteiktu
vērtību — piemēram, zīmolu nosaukumi) un **Procesa aizkave** milisekundēs, kas ļauj piebremzēt
procesu, lai tas neapēd visus servera resursus.

## DeepL API atslēgas iegūšana

DeepL piedāvā gan bezmaksas, gan maksas API plānu. Bezmaksas plānam ir ierobežots zīmju skaits
mēnesī, un reģistrācijas laikā tik un tā tiks prasīta adrese un maksājumu karte — DeepL to izmanto
personas identificēšanai.

1. Atveriet **deepl.com** un lapas augšējā labajā stūrī nospiediet izvēlnes ikonu.

   ![DeepL sākumlapa ar norādi uz izvēlnes ikonu; trešās puses vietne, joprojām derīga](https://chat.ecombaltic.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBa2tZIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--e692219f0d1682858f28c1632530074ddd80e6c7/d2.png)

2. Izvēlnē atrodiet **Sign up**.

   ![atvērta DeepL izvēlne ar iezīmētu «Sign up»](https://chat.ecombaltic.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBa29ZIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--f25c48805b19c3ce8bf7c1f03fd6f646842c5010/d3.png)

3. Plānu lapā pārslēdzieties uz cilni **DeepL API** un izvēlieties plānu. Bezmaksas plānam
   spiediet **Sign up for free**.

   ![DeepL plānu lapa, cilne «DeepL API», kartītes «DeepL API Free» un «DeepL API Pro»](https://chat.ecombaltic.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBa3NZIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--2a3bfacb5b1fc6728dcd6461e1241189a2d84865/d4.png)

4. Ievadiet e-pastu, pēc tam izdomājiet paroli un nospiediet **Create account**.

   ![DeepL reģistrācijas 1. solis: e-pasta lauks un poga «Continue»](https://chat.ecombaltic.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBazBZIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--200534c6150710d5d22fc33ccd8f940f00bdffc1/d5.png)

5. Aizpildiet adreses datus (valsts, vārds, uzvārds, adrese, pasta indekss, pilsēta).

   ![DeepL adreses forma ar valsti «Latvia»](https://chat.ecombaltic.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBazhZIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--00e481c7e953ee9039908750e7b2918c7396ec37/d7.png)

6. Norādiet maksājumu kartes datus identitātes pārbaudei, pēc tam atzīmējiet piekrišanu
   noteikumiem un nospiediet **Sign up for free**.

   ![DeepL reģistrācijas pēdējais solis «Review» ar plāna nosacījumiem un pogu «Sign up for free»](https://chat.ecombaltic.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBbEVZIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--2055f195a6b2019a42f8663cfbde0d0d3787b40c/d9.png)

7. Kad konts izveidots, atveriet savu DeepL kontu un pārejiet uz sadaļu **API Keys**.

   ![DeepL konta lapa ar cilnēm «Subscription / Account / API Keys / Usage / Invoices»](https://chat.ecombaltic.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBbE1ZIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--0d2b2c245074c1a96965593ba9481d93ff95b86f/d11.png)

8. Nokopējiet atslēgu ar kopēšanas ikonu blakus tai.

   ![DeepL «API Keys» saraksts ar maskētu atslēgu un kopēšanas ikonu](https://chat.ecombaltic.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBbFFZIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--634d5b68d7734c08df87fb1dc97ae4800b932818/d12.png)

**Ko ar to darīt panelī.** Cilnē **Iestatījumi** izvēlieties **Deepl**, ielīmējiet atslēgu laukā
**API atslēga** un — svarīgi — laukā **API galapunkts** izvēlieties adresi, kas atbilst jūsu
plānam:

| Jūsu DeepL plāns | Kuru **API galapunktu** izvēlēties |
|---|---|
| Bezmaksas (DeepL API Free) | `https://api-free.deepl.com/v2/translate` |
| Maksas (DeepL API Pro) | `https://api.deepl.com/v2/translate` |

Bezmaksas DeepL atslēgas beidzas ar `:fx` — tā ir ērtākā pazīme, pēc kā pārbaudīt, vai izvēlētais
galapunkts ir pareizais. Nepareizs galapunkts ir biežākais iemesls, kāpēc pareiza DeepL atslēga
«nestrādā».

Lauks **Glosārijs** ir neobligāts. Tajā katrā rindā raksta vienu ierakstu formā
`[avota valoda]-[mērķa valoda]:[glosārija id]`.

## Google Translate API atslēgas iegūšana

Google tulkošanas atslēgai ir vajadzīgs Google konts un Google Cloud projekts ar ieslēgtu norēķinu
kontu. Google jaunam kontam parasti piešķir izmēģinājuma kredītu ar termiņu; kad tas ir iztērēts vai
beidzies, par tulkošanu tiek rēķināts pēc simbolu skaita. Aktuālos izcenojumus skatiet Google Cloud
cenu lapā — šeit tos nenorādām tieši tāpēc, ka tie mēdz mainīties.

1. Atveriet Google Cloud Translation cenu lapu un nospiediet **Start free** vai
   **Try Translation free**.

   ![Google Cloud «Cloud Translation pricing» lapa ar pogām «Start free» / «Try Translation free»](https://chat.ecombaltic.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBc3dlIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--9d496b5e6f5883dce11b3f6f85901220e2976538/POVy647ueq.png)

2. Pirmajā solī norādiet valsti un organizācijas veidu un piekrītiet noteikumiem.

   ![Google Cloud reģistrācijas «Step 1 of 2 Account information»](https://chat.ecombaltic.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBczBlIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--dcb72abe23acc60a0bafb2051e6fc0d70ccf1075/J-HpS1FLh7.png)

3. Otrajā solī aizpildiet maksājumu profilu (tiks prasīti arī kartes dati) un sāciet bezmaksas
   izmēģinājumu.

4. Ievadapmācības logu var aizvērt ar **Skip for now**, un aptaujas logu — ar **Done**.

   ![Google Cloud «Get started with an interactive tutorial» ar norādi uz «Skip for now»](https://chat.ecombaltic.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBdEFlIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--54c362b8ce2fe824edde38dc146e51528dfa5db0/WrSzCjdcIr.png)

5. Kreisajā navigācijā atveriet **APIs and services → Credentials** un nospiediet
   **Create credentials**. Uznirstošajā logā parādīsies izveidotā atslēga.

   ![Google Cloud dialogs «API key created» un ceļš «APIs and services → Credentials → Create credentials»](https://chat.ecombaltic.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBdEVlIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--8c1e7dfa697936bfa12c8eb8a67175146a62d4a3/upt8y1OYgw.png)

6. Atveriet izveidoto atslēgu no **Credentials** saraksta, lai norādītu tās ierobežojumus.

   ![Google Cloud «Credentials» saraksts ar rindu «API key 1» un «SHOW KEY»](https://chat.ecombaltic.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBdDhlIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--9d653a874b949c25cabc145fa7b789e386bd2789/lXhFM7bZad-2.png)

   ![Google Cloud «Edit API key» ar «Application restrictions» un «API restrictions»](https://chat.ecombaltic.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBdDRlIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--0215c60cc456333ab7bb2234d2a498c1ac268374/mjEjepSPLM-2.png)

   ⚠️ Ekrānattēlā ierobežojumi ir atstāti kā **None** un **Don't restrict key**. Tā ir vienkāršākā,
   bet arī nedrošākā izvēle: šāda atslēga noplūdes gadījumā der visam. Drošāk sadaļā
   **API restrictions** atļaut tikai **Cloud Translation API**.

7. Visbeidzot projektam jāieslēdz pati tulkošanas API — atveriet **Cloud Translation API** un
   nospiediet **Enable**.

   ![Google Cloud «Cloud Translation API» lapa ar pogu «Enable»](https://chat.ecombaltic.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBdDBlIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--d0814702dd8e65dc40ee0ffd90f9d756eb8caf33/rCnt89jT3q.png)

**Ko ar to darīt panelī.** Cilnē **Iestatījumi** izvēlieties **Google Translate API**, ielīmējiet
atslēgu laukā **API atslēga** un izvēlieties **Tulkošanas dzinēju**. Noklusējuma izvēle ir
**Bāze — pamata tulkošanas dzinējs**; neironu dzinējs maksā dārgāk, un modulis pats brīdina, ka
rezultāts vairumā gadījumu ir tāds pats.

## Microsoft (Azure) tulkotāja API atslēgas iegūšana

Microsoft tulkotāja atslēgu izsniedz Azure portālā, izveidojot **Translator** resursu.

1. Izveidojiet kontu un pieteicieties **portal.azure.com**.
2. Kreisajā izvēlnē izvēlieties **Izveidot resursu** (*Create a resource*).
3. Meklējiet **Translator**, atlasiet to un nospiediet **Izveidot** (*Create*).
4. Lapā **Create Translator** aizpildiet abonementu, resursu grupu, resursa nosaukumu, reģionu un
   izvēlieties cenu līmeni.
5. Izskatiet un piekrītiet noteikumiem, pēc tam nospiediet **Create**.
6. Kad resurss ir izveidots, atveriet tā sadaļu **Keys and Endpoint**.

![Azure resurss «translator | Keys and Endpoint» ar iezīmētu KEY 1, Location/Region un Text Translation gala punktu](https://chat.ecombaltic.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBcW9xIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--5e11bbe84b340831a28c7b98d1aa5d0baf1b4375/microsoft-api.png)

**Ko ar to darīt panelī.** Cilnē **Iestatījumi** izvēlieties **Microsoft Translator**:

| Azure lauks | EcomCart lauks |
|---|---|
| **KEY 1** (vai KEY 2) | **API atslēga** |
| **Location/Region** (piem. `westeurope`, `westus2`) | **API reģions** |
| **Text Translation** gala punkts | nekur nav jāievada — modulis izmanto standarta adresi |

Reģions ir jāaizpilda vienmēr, izņemot gadījumu, kad Azure resurss ir izveidots ar reģionu
`global` — tad lauku var atstāt tukšu. Nepareizs vai neaizpildīts reģions ir biežākais Microsoft
atslēgas kļūmes cēlonis.

## Kā pārbaudīt, vai atslēga strādā

Modulī ir tam paredzēta cilne — **Testa tulkotājs**. Tā ir pirmā cilne, kas atveras.

1. **Vispirms pārliecinieties, ka atslēga ir saglabāta** — nospiediet **Saglabāt** ekrāna augšējā
   labajā stūrī. Testa tulkotājs izmanto saglabāto atslēgu, nevis to, kas tikko ierakstīta formā;
   ja pāriesiet uz testu, nesaglabājot, tests strādās ar veco vai tukšo atslēgu.
2. Laukā **Pārbaudes teksts** ierakstiet dažus teikumus (der arī HTML).
3. Izvēlieties **Avota valodu** (vai atstājiet **- Automātiska noteikšana -**) un **Mērķa valodu**.
4. Nospiediet **Tulkot**.
5. Rezultāts parādās laukā **Tulkotais rezultāts**.

> 📷 **Ekrānattēls:** extension/module/mass_translate — cilne «Testa tulkotājs» ar aizpildītu pārbaudes tekstu un rezultātu

ℹ️ Abos valodu sarakstos — gan šeit, gan cilnē **Masuveida tulkotājs** — ir tikai tās valodas, kas
veikalā ir uzstādītas. Ja avota valodas sarakstā vajadzīgās valodas nav, atstājiet
**- Automātiska noteikšana -**; ja sarakstā nav vajadzīgās mērķa valodas, tā vispirms jāpievieno
veikala valodu iestatījumos.

Šī pārbaude ir svarīga tāpēc, ka **Testa tulkotājs ir vienīgā vieta, kur pakalpojuma kļūdas teksts
tiek parādīts uzreiz**. Masveida tulkošanā daļa kļūdu pārtrauc procesu ar uznirstošu paziņojumu, bet
daļa vienkārši atstāj lauku tukšu, un neviens ekrāns to nepasaka. Vienmēr vispirms pārbaudiet
atslēgu šajā cilnē un tikai tad palaidiet masveida tulkošanu.

ℹ️ Divas atbildes, kas nav tulkojums. Ja cilnē **Iestatījumi** nav izvēlēts neviens pakalpojums,
laukā **Tulkotais rezultāts** parādās `Error: this api is not yet available`. Ja pakalpojums ir
izvēlēts, bet tā lauks **API atslēga** ir tukšs, kļūdas nav vispār — atpakaļ atnāk tieši tas pats
teksts, ko ievadījāt. Nemainīgs rezultāts tātad nozīmē nevis «tulkojums sakrīt», bet «atslēga
netiek izmantota».


## Ja kaut kas nestrādā

**Sadaļā «Rīki» nav punkta «Masveida tulkotājs».**
Trīs pārbaudes. Pirmkārt, vai veikala plāns ir PRO vai augstāks — zemākos plānos moduļa nav.
Otrkārt, vai jūsu lietotāja grupai ir atļauta piekļuve šim modulim — punkts izvēlnē parādās tikai
tad, un tiesības ieslēdz veikala administrators lietotāju grupas iestatījumos. Ja abi ir kārtībā —
rakstiet tehniskajam atbalstam.

**Visa moduļa vietā ir paziņojums par plānu.**
Masveida tulkotājs strādā no PRO plāna. Zemākā plānā ekrāns tiek aizstāts ar aprakstu un pogu
**Uzlabot plānu**.

**Tulkošana norit, bet lauki paliek tukši.**
Tas nozīmē, ka pakalpojums pieprasījumu noraida: masveida palaišanā noraidīts pieprasījums atgriež
tukšu vērtību, un ekrānā par to neparādās nekas. Vienīgā vieta, kur kļūdas tekstu var ieraudzīt, ir
cilne **Testa tulkotājs** — pārbaudiet atslēgu tur. DeepL gadījumā tipiskās atbildes ir
«Authorization failed» (nepareiza atslēga vai nepareizs **API galapunkts** — bezmaksas atslēgai
jāiet uz `api-free` adresi), «Quota exceeded»
(mēneša zīmju limits iztērēts) un «Too many requests» (par daudz pieprasījumu pēc kārtas — palīdz
palielināt **Procesa aizkavi**). Microsoft gadījumā vispirms pārbaudiet **API reģionu**, Google
gadījumā — vai projektam tiešām ir ieslēgta **Cloud Translation API** un vai atslēgas ierobežojumi
to neaizliedz.

Kļūmes, kas saistītas ar lauku **Avota valoda** un tulkošanas rāmi, ir aprakstītas rakstā [Mašīntulkošana — divi veidi un lauks «Avota valoda»](/hc/help2/articles/ecomlink-masintulkosana); kļūmes masveida palaišanā — rakstā [Masveida tulkošanas palaišana, izmaksas un atcelšana](/hc/help2/articles/ecomlink-masveida-tulkosanas-palaisana).