Tłumaczenia ofert - dodaliśmy nowe funkcjonalności / Offer translations - we have added new features

Udostępniliśmy dziś nowe funkcjonalności, za pomocą których możesz zarządzać tłumaczeniami swoich ofert. Dzięki temu kupujący zobaczą je w języku dostosowanym do ustawień na swoim koncie.

Oferty tłumaczymy automatycznie na język angielski (także za każdym razem, gdy zmienisz tytuł lub opis), jeśli:

* oferta jest w statusie ACTIVE,
* kraj, do którego możliwa jest wysyłka, jest różny od kraju operacyjnego serwisu,
* oferta jest w innym języku bazowym niż angielski,
* kategoria, w której wystawiona jest oferta, nie znajduje się na liście kategorii, których nie tłumaczymy (Książki i Antykwariat),
* oferta została wystawiona przez konto firmowe.

Możesz również przekazać nam własne tłumaczenie, w takim przypadku nie będziemy go automatycznie aktualizować.

**Jakie zmiany wprowadziliśmy?**

1. W strukturze zasobów /sale/offers/{offerId} i /sale/product-offers/{offerId} dodaliśmy nowe pole **“language”**, w którym możesz określić język bazowy oferty. **Na tę chwilę możesz przekazać w nim wyłącznie wartość “pl-PL”**. Do końca drugiego kwartału umożliwimy tworzenie ofert także w języku angielskim. Jeśli nie przekażesz tego pola, to domyślnie przypiszemy mu wartość “pl-PL”. **Język bazowy możesz zmienić wyłącznie, kiedy oferta jest w statusie INACTIVE (jest szkicem).** Wartość, którą wskażesz, jest podstawą do dalszych tłumaczeń oferty.
2. Udostępniliśmy nowe zasoby, za pomocą których możesz zarządzać tłumaczeniem tytułów i opisów swoich ofert:
1. [GET /sale/offers/{offerId}/translations](https://developer.allegro.pl/documentation/#operation/getOfferTranslationUsingGET) - pobierz listę dostępnych tłumaczeń dla wskazanej oferty. Za pomocą parametru **language** wskaż wartość w formacie [BCP-47](https://tools.ietf.org/rfc/bcp/bcp47), aby pobrać tłumaczenie w wybranym języku. Listę dostępnych wartości dla tego parametru znajdziesz w naszej dokumentacji;
2. [PATCH /sale/offers/{offerId}/translations/{language}](https://developer.allegro.pl/documentation/#operation/updateOfferTranslationUsingPATCH) - dodaj lub zmodyfikuj własne tłumaczenie oferty. Jako **{language}** wskaż jeden z dostępnych języków w formacie BCP-47, które wymieniliśmy w naszej dokumentacji;
3. [DELETE /sale/offers/{offerId}/translations/{language}](https://developer.allegro.pl/documentation/#operation/deleteManualTranslationUsingDELETE) - usuń wybrane własne tłumaczenie oferty. Za pomocą parametru **element** wskaż, czy chcesz usunąć tłumaczenie pola **“title”** albo **“description”**. Jeśli nie przekażesz tego parametru, usuniemy tłumaczenie obu sekcji.
3. W dzienniku ofertowym [GET /sale/offer-events](https://developer.allegro.pl/documentation/#operation/getOfferEventss) dodaliśmy nowe zdarzenie **"OFFER_TRANSLATION_UPDATED"**, w którym informujemy o aktualizacji tłumaczenia oferty.

Więcej informacji o nowych zasobach znajdziesz w [naszym poradniku](https://developer.allegro.pl/my_offers/#t%C5%82umaczenia-ofert).

-----

Today we have introduced new features that allow you to manage the translations of your offers. Thanks to that, buyers will be able to see them in a language adjusted to their account preferences.

We translate offers automatically into English (also each time you change title or description), if:

* the offer is in ACTIVE status,
* the country to which the shipment is possible differs from the country of the operating site,
* base offer language is different than English,
* the category in which the offer is listed is not on the list of categories we do not translate (Books and Antiquarian),
* the offer was listed via company account.

You can also provide us your own translation - in this case, we will not automatically update it.

**What changes have we made?**

1. In the structure of /sale/offers/{offerId} and /sale/product-offers/{offerId} resources, we have added a new field **“language”**, in which you can set the base language of the offer. **For now, you can provide only “pl-PL” value**. By the end of Q2, 2022, we will enable the possibility to list offers in English. If you will not send this field, we will automatically assign the “pl-PL” value. **You can change the offer base language only when offer is in INACTIVE status (draft).** The value you indicate is the basis for further translations of the offer.
2. We have released new resources, that manage the translation of title and description in your offers:
1. [GET /sale/offers/{offerId}/translations](https://developer.allegro.pl/documentation/#operation/getOfferTranslationUsingGET) - retrieve the list of available translations for the indicated offer. Using the **language** parameter select a value in the [BCP-47](https://tools.ietf.org/rfc/bcp/bcp47) format to retrieve the translation in the chosen language. You can find the list of available values for this parameter in our documentation.
2. [PATCH /sale/offers/{offerId}/translations/{language}](https://developer.allegro.pl/documentation/#operation/updateOfferTranslationUsingPATCH) - add or modify your own translation of the offer. As a **{language}**, indicate one of the available languages in [BCP-47](https://tools.ietf.org/rfc/bcp/bcp47), which we listed in our documentation.
3. [DELETE /sale/offers/{offerId}/translations/{language}](https://developer.allegro.pl/documentation/#operation/deleteManualTranslationUsingDELETE) - remove the chosen translation of the offer. Using the **element** parameter, choose whether you want to delete the translation of the **“title”** or **“description”** field. If you do not send this parameter, we will remove the translation of both sections.
3. In the offer journal [GET /sale/offer-events](https://developer.allegro.pl/documentation/#operation/getOfferEvents) we have added a new event **"OFFER_TRANSLATION_UPDATED"**, in which we inform about the update of the offer translation.

You can find more information about new resources in [our guide](https://developer.allegro.pl/en/my_offers/#offer-translations).