16 marca 2022
Tłumaczenia ofert - dodaliśmy nowe funkcjonalności
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?
- 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.
- Udostępniliśmy nowe zasoby, za pomocą których możesz zarządzać tłumaczeniem tytułów i opisów swoich ofert:
- GET /sale/offers/{offerId}/translations - pobierz listę dostępnych tłumaczeń dla wskazanej oferty. Za pomocą parametru language wskaż wartość w formacie BCP-47, aby pobrać tłumaczenie w wybranym języku. Listę dostępnych wartości dla tego parametru znajdziesz w naszej dokumentacji;
- PATCH /sale/offers/{offerId}/translations/{language} - 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;
- DELETE /sale/offers/{offerId}/translations/{language} - 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.
- W dzienniku ofertowym GET /sale/offer-events 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.