Informacje o wersji (v2.1)

18 sierpnia 2025 r.

Interfejs Content API został wycofany i zostanie wyłączony w sierpniu 2026 r. Migracja do interfejsu API sprzedawcy

19 czerwca 2025 r.

Usługa dotycząca produktów

Zasób produktu

Dodaliśmy pole maximum_retail_price, aby umożliwić określenie maksymalnej ceny detalicznej w Indiach.

Usługa pomocy dla sprzedawców

26 maja 2025 r.

Usługa kont

Do kont można teraz dodawać użytkowników z uprawnieniami tylko do odczytu.

Apr 14, 2025

Usługa kont

W przyszłości nie będzie to już wymagane, dlatego usługa accounttaxzostała wycofana.

Mar 17, 2025

W ramach wyłączenia interfejsów API związanych z zamówieniami wycofaliśmy te usługi:

  • accounts.verifyphonenumber
  • returnpolicy

Inne usługi

Ten punkt końcowy nie jest już wymagany i może zostać wycofany:

  • pubsubnotificationsettings

10 lutego 2025 r.

Dodano prerendered_out_of_court_dispute_settlement pola do ProductIssueAccountIssue.

Wycofane pola alternate_dispute_resolutionRenderProductIssuesResponseRenderAccountIssuesResponse.

12 grudnia 2024 r.

Usługa dotycząca produktów

Dodaliśmy pole sustainability_incentives, aby określić zachęty związane ze zrównoważonym rozwojem, takie jak ulga podatkowa lub rabat na produkty. Jeśli wartość pola nie zostanie podana, produkt nie będzie kwalifikować się do żadnych zachęt związanych ze zrównoważonym rozwojem.

Nov 15, 2024

Usługa dotycząca produktów

W przypadku LoyaltyProgram dodano pole shipping_label do określania kryteriów kwalifikacji. Jeśli pole ma wartość, ta oferta ma korzyść z dostawy w ramach programu lojalnościowego. Jeśli wartość pola nie zostanie podana, produkt nie kwalifikuje się do dostawy w programie lojalnościowym na danym poziomie lojalnościowym.

30 października 2024 r.

W ramach wyłączenia interfejsów API związanych z rozliczeniami te usługi zostaną wycofane:

  • settlementreports
  • settlementtranscations

Wyłączenie interfejsów API związanych z rozliczeniami jest powiązane z wcześniejszym wyłączeniem programu Kupuj w Google i interfejsów API związanych z zamówieniami.

Wywołania wspomnianych usług powinny zakończyć się niepowodzeniem i zwrócić odpowiedź Service was not found on the server.

16 października 2024 r.

update_mask w UpdateConversionSourceRequest to teraz OPTIONAL. Jeśli nie podasz maski aktualizacji, zaktualizowane zostaną wszystkie pola, które mają niepustą wartość.

26 sierpnia 2024 r. (wcześniej niż pierwotnie podano)

W ramach wyłączenia interfejsów API związanych z zamówieniami wycofaliśmy te usługi:

  • orderinvoices
  • orderreports
  • orderreturns
  • orderreturns.labels
  • orders

Wywołania wspomnianych usług powinny zakończyć się niepowodzeniem i zwrócić odpowiedź Service was not found on the server.

Usługa OrderTrackingSignals nie została wycofana i jest nadal dostępna.

10 sierpnia 2024 r.

Usługi Kup w Google

W ramach wyłączenia interfejsów API Kup przez Google wszystkie metody w BuyOnGoogleProgramService przestaną działać i będą zwracać błąd service was not found on the server.

19 lipca 2024 r.

Usługa dotycząca produktów

Dodano pole member_price_effective_date. Ta aktualizacja umożliwia określenie zakresu dat, w którym obowiązuje cena dla uczestników programu lojalnościowego. Jeśli wartość pola nie zostanie podana, cena dla uczestników programu będzie obowiązywać zawsze.

20 maja 2024 r.

Usługa dotycząca produktów

Dodano LoyaltyPrograms. Ta aktualizacja umożliwia podanie wielu poziomów z różnymi punktami lojalnościowymi, cenami itp. dla jednego produktu. Zamiast pojedynczego pola LoyaltyProgram użyj tego pola.

Usługa raportów

Wycofane dane Kup przez Google w MerchantPerformanceViewtabeli. Po tej aktualizacji pobieranie dowolnych danych Kup przez Google będzie zwracać wartość 0. Dotyczy to też wartości historycznych z poprzednich dat.

Więcej informacji znajdziesz w artykule Wycofanie Kup przez Google.

13 maja 2024 r.

Usługa dotycząca produktów

Zasób produktu

Zmiany w polu certyfikaty: dodano certificationValue do pola ProductCertification, aby podać wartość certyfikatu (znaną też jako klasa, poziom lub ocena), która umożliwia użytkownikom przesyłanie informacji o certyfikacie, nawet jeśli organ certyfikujący nie wydaje kodu ani numeru certyfikatu.

Więcej informacji znajdziesz w przewodnikach po produktach.

6 maja 2024 r.

Usługa raportów

Dodano do tabeli PriceInsightsProductView przedział skuteczności. Wskaźnik Skuteczność informuje, które produkty najbardziej skorzystają na zmianie cen. Ocena ta uwzględnia przewidywany wzrost skuteczności wynikający z dostosowania ceny promocyjnej oraz różnicy między ceną bieżącą a sugerowaną.

24 kwietnia 2024 r.

Usługa dotycząca produktów

Zasób produktu

Dodano opcjonalne pola downpaymentcreditType dla płatności ratalnych:

  • downpayment podaje kwotę, którą kupujący musi zapłacić z góry w ramach płatności jednorazowej.
  • creditType podaje typ płatności ratalnej (finance lub lease). To pole ma zastosowanie tylko w przypadku reklam pojazdów.

11 kwietnia 2024 r.

Usługa dotycząca produktów

Zasób produktu

  • Dodano atrybut próg bezpłatnej dostawy (FreeShippingThreshold) dla dostawy na poziomie oferty. Ten atrybut umożliwia sprzedawcom podanie minimalnej ceny produktu, przy której koszt dostawy staje się bezpłatny.
  • zmienił(a) widoczność LoyaltyPoints.

10 kwietnia 2024 r.

Usługa dotycząca produktów

Zasób produktu

Dodano stronę LoyaltyProgram

9 kwietnia 2024 r.

Usługa dotycząca produktów

Zasób produktu

Dodano structuredTitle i structuredDescription, aby umożliwić podawanie tytułów i opisów produktów generowanych przez AI.

3 kwietnia 2024 r.

Usługa pomocy dla sprzedawców

Dodaliśmy pole user_input_action_option, które umożliwia partnerom zgłaszanie prośby o nowy typ działania: BuiltInUserInputAction. Ta czynność umożliwia partnerom tworzenie złożonych funkcji samoobsługowych dla sprzedawców bezpośrednio w ich aplikacji, zamiast przekierowywać ich do Merchant Center.

Dodaliśmy nową metodę TriggerAction dla BuiltInUserInputAction. Aby uzyskać dostęp do tej metody, prześlij prośbę za pomocą tego formularza.

27 marca 2024 r.

Usługa dotycząca produktów

Zasób produktu

Dodano AutoPricingMinPrice jako zabezpieczenie w projektach „Rabaty automatyczne” i „Promocje dynamiczne”, aby rabaty na oferty sprzedawców nie obniżały ceny produktu poniżej tej wartości. Dzięki temu zachowasz wartość i rentowność oferty.

15 marca 2024 r.

Wyłączenie usługi Kup przez Google w wyszukiwarce i Zakupach Google. Istniejące zamówienia możesz wyświetlać do 31 października 2024 r. za pomocą orders.listorders.get.

8 marca 2024 r.

Usługa raportów

Dodano raport TopicTrendsView do usługi Reports.

Więcej informacji znajdziesz w przewodnikach po raportowaniu.

6 marca 2024 roku

Usługa raportowania

Dodaliśmy przedział potencjalnej liczby kliknięć i pozycję produktów.

Więcej informacji znajdziesz w przewodnikach po raportowaniu.

19 lutego 2024 r.

Usługa ConversionSources

Usunęliśmy te wartości jako prawidłowe źródła konwersji:

  • CROSS_CHANNEL_FIRST_CLICK
  • CROSS_CHANNEL_LINEAR
  • CROSS_CHANNEL_POSITION_BASED
  • CROSS_CHANNEL_TIME_DECAY

Usunęliśmy opcje 60 i 90 dni jako okresy ważności i dodaliśmy 40 dni jako prawidłową opcję.

17 stycznia 2024 r.

usługa POS,

Dodaliśmy nowe wartości w przypadku pola matching_status_hint w tabeli PosStore, które umożliwiają użytkownikom uzyskanie szczegółowych informacji o tym, dlaczego dopasowanie sklepu nie powiodło się.

11 stycznia 2024 r.

Usługa kont

Dodano localProductManager i localProductManagement jako typ linku i usługę odpowiednio dla metody link. Umożliwiają one łączenie kont w celu zarządzania danymi o produktach dostępnych lokalnie.

29 listopada 2023 r.

Usługa pomocy dla sprzedawców

Dodano VERIFY_IDENTITY_IN_MERCHANT_CENTER zewnętrzny typ działania w przypadku weryfikacji tożsamości, którą należy przeprowadzić w Merchant Center.

usługa POS,

Dodaliśmy pola matching_status i matching_status_hint do elementu PosStore, które informują użytkowników o stanie dopasowania sklepu – punktu sprzedaży do sklepu w Profilu Firmy w Google i podpowiadają, jak rozwiązać problem.

15 listopada 2023 r.

Punkty końcowe repricingrulesrepricingrules.repricingreports nie są już obsługiwane.

1 listopada 2023 r.

Usługa Ustawienia dostawy

shipment_type=pickup nie jest już obsługiwany.

18 października 2023 r.

Usługa kont

Dodano pole Business Identity, które umożliwia sprzedawcom samodzielne określanie, czy ich produkty są zgodne z określonymi wartościami konsumenckimi.

10 października 2023 r.

Dodaliśmy Collection Point jako nowy typ przesyłki w usłudze ustawień dostawy. Dostawa do punktu odbioru to usługa świadczona przez podmiot zewnętrzny (np.nie przez sprzedawcę), w ramach której produkt jest dostarczany do lokalizacji powiązanej z podmiotem zewnętrznym (np. punktów dostępu UPS), a nie bezpośrednio do domu.

18 września 2023 r.

Usługa ustawień reklam lokalnego asortymentu produktów

Dodano metodę setOmnichannelExperience, która umożliwia użytkownikom konfigurowanie doświadczeń w ramach sprzedaży wielokanałowej (czyli ustawień lokalnego sklepu i odbioru). Obecnie ta funkcja jest dostępna tylko dla użytkowników, których dostawca systemu POS jest zaufany i może włączyć takie ustawienia.

7 września 2023 r.

Wycofanie usługi Kup przez Google

Dodanie nowego stanu DEPRECATED do metody GetBuyOnGoogleProgramStastus. Ponowna aktywacja lub wstrzymanie programu w takim stanie nie jest możliwe.

4 września 2023 r.

Usługa pomocy dla sprzedawców

Dodano FIX_ACCOUNT_ISSUE wbudowane działanie w przypadku problemów z produktami, które należy rozwiązać na poziomie konta. Dodano SHOW_ADDITIONAL_CONTENTwbudowane działanieSHOW_ADDITIONAL_CONTENT, które będzie używane do przekazywania uzasadnienia od organu państwowego.

28 sierpnia 2023 r.

Usługa promocji

Otwórz metodę list w usłudze Promotions, aby zmienić dostęp z ograniczonego na pełny.

22 sierpnia 2023 r.

Usługa pomocy dla sprzedawców

Uruchomienie usługi pomocy dla sprzedawców. Ta usługa zawiera treści pomocy dotyczące problemów z kontem i produktem.

4 sierpnia 2023 r.

Usługa raportów

Dodaliśmy do usługi Raporty raport Widoczność na tle konkurencji w przypadku bliskich konkurentów.

Więcej informacji znajdziesz w przewodnikach po raportowaniu.

25 lipca 2023 r.

Usługa POS

Zasób reklamowy

Dodaj pola pickup_method i pickup_sla, aby umożliwić sprzedawcom przesyłanie informacji o odbiorze wraz z asortymentem.

14 lipca 2023 r.

Usługa raportów

Dodaliśmy raporty Widoczność na tle konkurencji do usługi Raporty.

Więcej informacji znajdziesz w przewodnikach po raportowaniu.

7 lipca 2023 r.

Usługa dotycząca produktów

Zasób produktu

Dodano virtualModelLink, aby podać adresy URL obrazu modelu 3D.

4 lipca 2023 r.

Usługa dotycząca produktów

Zasób produktu

Dodaj pole certifications, aby podać certyfikaty produktów, np. etykiety efektywności energetycznej produktów na podstawie bazy danych EPREL UE.

26 czerwca 2023 r.

Usługa Ustawienia dostawy

Lokalna realizacja zamówień

Dodano pole no_delivery_post_cutoff, aby umożliwić sprzedawcom rezygnację z wyświetlania dostawy lokalnej w ciągu n+1 dnia, gdy mają skonfigurowaną usługę dostawy lokalnej w ciągu n dni.

29 maja 2023 r.

Usługa promocji

Dodano metodę list dla usługi Promotions.

Usługa rekomendacji

Włącz odrzucanie interakcji w metodzie ReportInteraction usługi Recommendations.

9 maja 2023 r.

Miejsce docelowe Cloud Retail

Dodatkowe właściwości Cloud Retail

Dodaj pole dodatkowych właściwości handlu w chmurze. Jest to pole powtarzane, które jest przeznaczone dla klientów korzystających z miejsca docelowego Cloud Retail. Gdy to pole jest używane, jest dostępne w ramach programu Cloud Retail. Zostanie on zmapowany na pole atrybutów w modelu usługi Google Cloud Retail.

22 maja 2023 r.

Usługa promocji

Dodano metodę list dla usługi Promotions.

11 kwietnia 2023 r.

Usługa Ustawienia dostawy

Lokalna realizacja zamówień

Dodaliśmy opcję realizacji dostawy lokalnej dla sprzedawców, którzy tworzą nowe ustawienia dostawy. Mogą skonfigurować ustawienia dla sklepów stacjonarnych w nowym polustoreConfig. Obejmuje to promień usługi, godzinę graniczną i kody sklepów oferujących dostawę lokalną.

3 kwietnia

Usługa rekomendacji

Uruchomiono usługę rekomendacji. Ta usługa podpowiada, jak zwiększyć skuteczność konta sprzedawcy, i umożliwia zgłaszanie kliknięć sprzedawców w przypadku przydatnych rekomendacji.

20 lutego 2023 r.

Usługa Konta

Zasób konta

Dodano nową sekcję Account.ConversionSettings w zasobie Accounts.

Usługa ConversionSources

Dodaliśmy usługę Źródła konwersji, która umożliwia zarządzanie źródłami konwersji (w sekcji Ustawienia konwersji w Merchant Center).

16 lutego 2023 r.

Usługa Ustawienia dostawy

Weryfikacja kodu sklepu

Kody sklepów są teraz weryfikowane, aby upewnić się, że należą do sprzedawcy, zanim zostaną zaktualizowane ustawienia dostawy.

Weryfikacja sprzedawców w ramach LIA

Programy, w których sprzedawca jest zarejestrowany, są teraz weryfikowane przed zaktualizowaniem ustawień dostawy. Sprzedawcy muszą uczestniczyć w jednym z tych programów:

  • LOCAL_INVENTORY_ON_SURFACES_ACROSS_GOOGLE
  • LOCAL_INVENTORY_ADS

9 lutego 2023 r.

Usługa promocji

Rozszerz usługę Promocje o 6 dodatkowych targetCountry opcji z lokalną contentLanguage obsługą:

  • BR
  • ES
  • NL
  • JP
  • IT
  • KR

12 stycznia 2023 r.

Usługa dotycząca produktów

Zasób produktu

Dodano atrybut lifestyleImageLinks, aby podawać adresy URL zdjęć produktu w kontekście.

24 listopada 2022 r.

Usługa promocji

Dodaliśmy nowe pole „promotionStatus” w sekcji Promotions.PromotionStatus. To pole jest tylko do odczytu.

15 listopada 2022 r.

Usługa raportów

Dodaliśmy raporty Trendy rynkowe do usługi Raporty.

Możesz teraz wysyłać do usługi Raporty zapytania dotyczące tych kwestii:

Więcej informacji znajdziesz w przewodnikach po raportowaniu.

7 listopada 2022 r.

Usługa plików danych

Dodaliśmy obsługę feedLabel w usłudze Pliki danych.

14 września 2022 r.

Zaktualizowano feedLabel tak, aby akceptować dowolny ciąg znaków.

9 sierpnia 2022 r.

Dodano feedLabel w przypadku produktów.

Zamiast targetCountry możesz teraz używać feedLabel, aby określić kraj dla identyfikatorów ofert. Identyfikatory ofert są teraz tworzone w formacie online:language:feedLabel:offerId.

feedLabel zostało automatycznie wypełnione wartością targetCountry w przypadku istniejących plików danych, aby zapewnić zgodność wsteczną.

Wycofano targetCountry.

Aby obsługiwać oferty globalne, w Content API for Shopping wycofaliśmy pole targetCountry. Zamiast tego zalecamy użycie pola shipping do określania krajów docelowych.

Pole targetCountry jest teraz automatycznie wypełniane wartością podaną w polu feedLabel.

Więcej informacji znajdziesz w artykule na blogu Etykieta pliku danych zastępuje kraj docelowy w Content API for Shopping.

8 grudnia 2021 r.

Usługa Konta

Zasób konta

Dodano nową sekcję Account.AutomaticImprovements w zasobie Accounts.

Ta nowa sekcja umożliwi sprzedawcom automatyczne aktualizowanie produktów, ulepszanie zdjęć i ustawień dostawy.

25 października 2021 r.

Usługa promocji

Dodano funkcję Get Promotion do interfejsu API promocji.

11 października 2021 r.

Shipping Settings API

Dodano nowe pole warehouse w zasobie ShippingSettings, aby umożliwić sprzedawcom zarządzanie magazynami, które mogą być używane w WarehouseBasedDeliveryTime.

Dodaj nowe pole warehouseName w elemencie WarehouseBasedDeliveryTime, aby odwoływać się do magazynu za pomocą nazwy magazynu.

4 października 2021 r.

Usługa Konta

Zasób konta

Dodano nowe pole „phone_verification_status” w sekcji Accounts.BusinessInformation. Jest to pole tylko do odczytu, ustawiane przez funkcję Accounts.VerifyPhoneNumber.

13 września 2021 r.

Usługa BuyOnGooglePrograms

Zasób BuyOnGoogleProgramStatus

Dodaliśmy nowe pola w zasobie BuyOnGooglePrograms.BuyOnProgramStatus, które reprezentują: kanały sprzedaży online, modele biznesowe i numer telefonu obsługi klienta.

Nowa metoda UpdateBuyOnGoogleProgramStatus

Dodano nową metodę UpdateBuyOnGoogleProgramStatus, która umożliwia aktualizowanie rozszerzonego zasobu BuyOnGooglePrograms.BuyOnProgramStatus.

6 września 2021 r.

Usługa Konta

Zasób konta

Dodaliśmy nowe pole „korean_business_registration_number” w sekcji Accounts.BusinessInformation. To pole zostanie wyczyszczone tylko wtedy, gdy zostanie wyraźnie ustawione na pusty ciąg znaków.

30 sierpnia 2021 r.

Usługa promocji

Dodano nową usługę promocyjną z dostępną funkcją wstawiania promocji.

Usługa zamówień

Dodaliśmy nową metodę orders/captureOrder, która umożliwia pobieranie środków przed wysyłką.

Przyczyna anulowania nowego zamówienia FAILED_TO_CAPTURE_FUNDS

Usługa dotycząca produktów

Zasób produktu

Dodano atrybuty productLength, productHeight, productWidth i productWeight, aby podać wymiary i wagę produktu.

9 sierpnia 2021 r.

Usługa RepricingRule

Typ RepricingRule

Nowa wartość wyliczeniowa w polu RepricingRuleType.

Dodano: TYPE_SALES_VOLUME_BASEDTYPE_COMPETITIVE_PRICE.

17 maja 2021 r.

Usługa etykiet zwrotów zamówień

Dodano nowe pole „product_id” w metodzie CreateReturnRequest. Sprzedawcy mogą określić identyfikator produktu lub identyfikator pozycji, aby zidentyfikować zwracany produkt.

Usługa dotycząca produktów

Dodaliśmy nową metodę aktualizowania istniejących produktów. Aby zaktualizować produkt, możesz podać tylko pola, które wymagają aktualizacji, zamiast całego produktu.

3 maja 2021 r.

Usługa etykiet zwrotów zamówień

Dodaliśmy nowe metody przesyłania etykiet w przypadku zwrotów zarządzanych przez sprzedawcę. Dzięki nowej funkcji orderreturns.labels.create możesz przesyłać etykiety zwrotne, aby udostępniać je klientowi.

26 kwietnia 2021 r.

Shipping Settings API

Nowe pole warehouseBasedDeliveryTimes w elemencie DeliveryTime, które umożliwia usługom dostawy obliczanie przewidywanej daty dostawy na podstawie lokalizacji magazynu i wybranej usługi przewoźnika.

Nowe pole eddServices w obiekcie CarriersCarrier, które zwraca nazwy usług mających zastosowanie do obliczania szacowanej daty dostawy.

12 kwietnia 2021 r.

Usługa dotycząca produktów

Zasób produktu

Nowe pole additionalSizeType obsługujące do 2 rodzajów rozmiaru na produkt.

Zmiany w polu dostawy: dodano minHandlingTime, maxHandlingTime, minTransitTime i maxTransitTime do ProductShipping, aby zapewnić szybkość dostawy na poziomie oferty.

28 stycznia 2021 r.

Usługa Konta

Dodaliśmy obsługę automatycznych etykiet w przypadku zasobów AccountLabelAccount. Więcej informacji znajdziesz w sekcji Rodzaje etykiet CSS w przewodniku po zarządzaniu etykietami CSS.

5 października 2020 r.

Usługa CSSES

Zasób CSS

Dodaliśmy nową usługę csses do pobierania informacji o domenach usługi porównywania cen i przypisywania do nich etykiet. Zasób AccountLabel można teraz też wykorzystywać do tworzenia i wyświetlania etykiet na poziomie grupy usług porównywania cen. Więcej informacji znajdziesz w artykule Zarządzanie etykietami CSS.

24 sierpnia 2020 r.

Usługa dotycząca produktów

Zasób Products

Nowe pole shoppingAdsExcludedCountries, które umożliwia wykluczenie ofert z reklam w określonych krajach.

Zasób Productstatuses

Nowe pola approvedCountries, pendingCountries i disapprovedCountries w obiekcie destinationStatuses, które zawierają informacje o stanie oferty wykraczające poza targetCountry.

Nowe pole itemLevelIssues.applicableCountries.

10 sierpnia 2020 r.

Usługa Konta

Dodaliśmy nowy zasób AccountLabel do zarządzania etykietami kont Merchant Center w CSS Center. Użytkownicy CSS Center mogą teraz też wyświetlać swoje konta Merchant Center i przypisywać do nich etykiety za pomocą metod accounts.list, accounts.get i accounts.updatelabels. Więcej informacji znajdziesz w artykule Zarządzanie etykietami CSS.

19 czerwca 2020 r.

Usługa dotycząca produktów

Zasób produktu

Nowe pola

Nowe pola productDetails, productHighlights, subscriptionCostcanonicalLink.

2 czerwca 2020 r.

Usługa zamówień

Dodaliśmy nowe metody inicjowania zwrotów środków bez zwrotu produktu. Dzięki nowym funkcjom orders.refunditem i orders.refundorder możesz inicjować zwroty środków za zamówienia, nawet jeśli klient nie zwróci produktów.

27 kwietnia 2020 r.

Usługa Orderreturns

Dodaliśmy nowe metody acknowledgeprocess oraz nowe filtry i pola dla metod odczytu (list, get).

Łączenie z GMF

Dodaliśmy możliwość łączenia kont Merchant Center z kontem Google Moja Firma za pomocą identyfikatora konta Google Moja Firma.

14 kwietnia 2020 r.

Interfejsy API raportu rozliczeniowego

Dodaliśmy nową usługę do pobierania raportów rozliczeniowych.

9 marca 2020 r.

Local Inventory API

Dodaliśmy nową usługę przesyłania danych o lokalnym asortymencie.

2 marca 2020 r.

Pubsub notification settings API

Dodaliśmy nową usługę do zarządzania ustawieniami powiadomień pubsub.

3 grudnia 2019 r.

Usługa dotycząca produktów

Dodano obsługę dodatkowych plików danych Content API dla multikont klientów.

11 września 2019 r.

Usługa zamówień

Dodaliśmy obsługę przesyłek z odbiorem w zamówieniach i odpowiednich funkcji w środowisku piaskownicy.

14 sierpnia 2019 r.

Nowe usługi

Dodano nowe usługi Returnpolicy i Returnaddress dla Kup przez Google.

Usługa zamówień

Zasób zamówienia

Nowe pole

Nowe pole quantityUndeliverable.

7 sierpnia 2019 r.

Usługa zamówień

Zasób zamówienia

Nowe pola

Dodaliśmy nowe pola loyaltyInfoinvoiceReceivingEmail do zasobu Order.

1 lipca 2019 r.

Usługa dotycząca produktów

Dodano obsługę dodatkowych plików danych Content API w usłudze Produkty.

11 czerwca 2019 r.

Usługa zamówień

Zasoby Order i TestOrder

Dodawanie korekty ceny

Dodano nowe pole lineItem[].adjustments, które zawiera korektę pierwotnej ceny pozycji i podatku spowodowaną zastosowaniem promocji.

14 lutego 2019 r.

Zmiany wprowadzone w tej wersji

Uruchomienia próbne nie są już obsługiwane

Parametr dryRun został usunięty z wersji 2.1. Dotyczy to wszystkich wywołań interfejsu API.

Metody PATCH nie są już obsługiwane

Te usługi nie obsługują już metody patch:

  • Konta
  • Accounttax
  • Pliki danych
  • Liasettings
  • Shippingsettings

Usunięcie metod HTTP BATCH

Wszystkie metody HTTP BATCH zostały usunięte z wersji 2.1. Zamiast niej używaj zasady customBatch. Usługi, których dotyczy problem:

  • Konta
  • Accountstatuses
  • Pliki danych
  • Datafeedstatuses
  • Liasettings
  • Orderreports
  • Poz.
  • Produkty
  • Productstatuses
  • Shippingsettings

Usługa Konta

Aktualizuj

Pola businessInformation i googleMyBusinessLink w żądaniu zostały wprowadzone po początkowym udostępnieniu Content API w wersji 2. Dlatego istnieje zabezpieczenie, które zapobiega przypadkowemu usunięciu informacji w tych 2 polach przez sprzedawców za pomocą znaku update, jeśli nie zostały one podane.

W wersji 2 sprzedawcy muszą wyraźnie podać te pola z pustą treścią ( {}), aby je usunąć. W wersji 2.1 pola są usuwane, jeśli podasz pustą treść lub jeśli ich nie podasz.

Zasób konta

Zmiana nazwy AdWords na Google Ads

W związku ze zmianą nazwy AdWords na Google Ads zmieniliśmy nazwy tych pól związanych z AdWords:

  1. adwordsLinks -> adsLinks
  2. adwordsLinks.adwordsId -> adsLinks.adsId
Usuwanie wycofanych pól i wartości

Wycofane pole reviewsUrl zostało usunięte. Dodatkowo usunęliśmy stan połączeniainactive w przypadku usług adsLinks, googleMyBusinessLinkyoutubeChannelLinks.

Usługa Accountstatuses

Zasób AccountStatus

Usuwanie elementu dataQualityIssues

Zostały one zastąpione przez itemLevelIssues.

Usługa przesyłania danych

Zasób pliku danych

Usuwanie wycofanych pól

Pola contentLanguage, targetCountryintendedDestinations zostały usunięte i zastąpione polami country, language, includedDestinationsexcludedDestinationstargets.

Usuwanie aktualizacji asortymentu produktów

Pliki danych typu product inventory update zostały usunięte.

Usługa Inventory Service

Usługa inventory w wersji 2 została usunięta i zastąpiona 2 nowymi funkcjami w wersji 2.1:

Usługa zamówień

CancelLineItem

Pola amount, amountPretaxamountTax w żądaniu zostały usunięte. Zwrócona kwota jest teraz obliczana automatycznie.

CustomBatch

Element CustomBatch został usunięty z wersji 2.1.

InStoreRefundLineItem

Pola amountPretaxamountTax zostały zastąpione odpowiednio polami priceAmounttaxAmount. Pole priceAmount może zawierać kwotę przed opodatkowaniem lub po opodatkowaniu w zależności od lokalizacji zamówienia.

Zwrot środków

Ta metoda została usunięta. Zamiast niej używaj zasady returnRefundLineItem.

ReturnLineItem

Ta metoda została usunięta. Zamiast tego użyj returnRefundLineItem bez podawania kwoty zwrotu.

ReturnRefundLineItem

Pola amountPretaxamountTax zostały zastąpione odpowiednio polami priceAmounttaxAmount. Pole priceAmount może zawierać kwotę przed opodatkowaniem lub po opodatkowaniu w zależności od lokalizacji zamówienia.

ShipLineItem

Pola carrier, shipmentIdtrackingId w żądaniu zostały przeniesione do shipmentInfos.

Zasoby Order i TestOrder

Nowy format promocji

W wersji 2.1 dostępny jest nowy format promocji. Nie możesz tworzyć zamówień testowych z promocjami.

Usuwanie wycofanych pól

Pole paymentMethod zostało usunięte, a pola billingAddresspredefinedBillingAddress są teraz polami najwyższego poziomu odpowiednio w OrderTestOrder.

Ponadto parametr customer.explicitMarketingPreference został usunięty i zastąpiony parametrem customer.marketingRightsInfo zarówno w przypadku funkcji Order, jak i TestOrder.

Wycofane pole customer.email zostało usunięte.

Format pola promotions w zasobie Order uległ zmianie.

Usługa Orderpayments

Ta usługa została usunięta z wersji 2.1.

Usługa dotycząca produktów

Odpowiedź z insert będzie zawierać tylko te atrybuty:

  • channel
  • contentLanguage
  • id
  • offerId
  • targetCountry

W odpowiedzi nie są już zwracane ostrzeżenia i błędy niekrytyczne. Umożliwia to lepszą integrację z regułami pliku danych i innymi zaawansowanymi funkcjami zarządzania plikiem danych.

Teraz, zanim wstawiony produkt będzie można pobrać za pomocą funkcji get lub list, musi upłynąć kilka minut.

Zwrócony identyfikator oferty nie musi być już taki sam jak identyfikator oferty wejściowej.

Ceny są teraz weryfikowane przed wstawieniem produktu. W ciągu wartości dozwolone są tylko te znaki: +, -, . i cyfry (09). Przecinki nie są już akceptowane.

Zasób produktu

CustomGroups zastąpione przez rekursywne atrybuty niestandardowe

Wcześniej atrybuty niestandardowe można było grupować, dodając je w wersji 2 w ramach tej samej grupy niestandardowej. Atrybuty niestandardowe w wersji 2.1 są teraz rekurencyjne, więc nie ma potrzeby stosowania grup niestandardowych.

Atrybuty niestandardowe mają teraz dodatkowe pole groupValues oprócz pierwotnego pola value. Musi być ustawione dokładnie jedno z nich, co oznacza, że nie można ich ustawić jednocześnie ani pominąć.

Sprzedawcy mogą przełączać się między wersjami 2 i 2.1, dlatego produkty mogą mieć rekursywne atrybuty niestandardowe, których nie można przedstawić w wersji 2, ponieważ grupy niestandardowe mają maksymalnie 2 poziomy. W takim przypadku grupa atrybutów niestandardowych zostanie obcięta.

Usuwanie typu i jednostki w atrybutach niestandardowych

W wersji 2.1 atrybuty niestandardowe nie będą już zawierać znaków typeunit. Zamiast tego jednostki należy dołączyć do value (jeśli występuje), a typy powinny być wykrywane automatycznie. Na przykład w wersji 2.1 użyj wartości „1,23 PLN” lub „5,6 cm” jako value.

ProductTypes zastępuje productType i additionalProductTypes

Wcześniej typy produktów były przechowywane w 2 polach: pierwszy typ w polu pojedynczym productType, a pozostałe w polu powtarzanym additionalProductTypes. W wersji 2.1 te 2 pola zostały zastąpione jednym polem powtarzanym productTypes.

Atrybut miejsca docelowe zastąpiony atrybutami uwzględnione_miejsca_docelowe i wykluczone_miejsca_docelowe

Miejsca docelowe były wprowadzane jako lista par nazwy miejsca docelowego i intencji w wersji 2 w powtarzanym polu destinations. To pole zostało zastąpione tymi 2 powtórzonymi polami: includedDestinationsexcludedDestinations. Miejsc docelowych włączonych domyślnie nie trzeba uwzględniać w includedDestinations.. Będzie to zgodne z konfiguracją zastąpień miejsc docelowych w plikach danych.

W związku ze zmianą nazwy AdWords na Google Ads zmieniliśmy nazwy tych pól związanych z AdWords:

  • adwordsGrouping -> adsGrouping
  • adwordsLabels -> adsLabels
  • adwordsRedirect -> adsRedirect
Usuwanie wycofanych pól

Usunęliśmy te pola, które nie są już używane:

  • aspects
  • destinations
  • onlineOnly
  • validatedDestinations
  • warnings

Usługa Productstatuses

Pobierz i wyświetl

Atrybut product został usunięty wraz z parametrem includeAttributes. Aby pobrać atrybuty produktu odpowiadające danemu stanowi, użyj usługi Products i wartości nowego pola productId.

Lista

Parametr includeInvalidInsertedItems został usunięty. Wszystkie produkty są teraz zwracane niezależnie od tego, czy są prawidłowe, co oznacza, że list działa teraz tak, jakby includeInvalidInsertedItems było zawsze ustawione na true.

Zasób ProductStatus

DestinationsStatuses

Pola intention, approvalStatusapprovalPendingdestinationStatuses zostały zastąpione polem status, które jest ciągiem znaków i może przyjmować jedną z tych wartości: approved, disapproved lub pending.

Usuwanie elementu dataQualityIssues

Zostały one zastąpione przez itemLevelIssues.