Informacje o wersji (v2.1)

30 października 2024 r.

W ramach wyłączenia interfejsów API związanych z ugodą wycofujemy następujące usługi: – settlementreports – settlementtranscations

Wyłączenie interfejsów API związanych z rozliczeniami jest związane z wcześniej zamkniętym programem Kup przez Google i interfejsami API związanymi z zamówieniami.

Połączenia z wymienionymi wyżej usługami powinny kończyć się niepowodzeniem i odpowiedzią Service was not found on the server.

16 października 2024 r.

Wartość update_mask w tabeli 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 informowano)

W ramach wyłączania interfejsów API związanych z zamówieniami wycofane zostały te usługi: - orderinvoices - orderreports - orderreturns - orderreturns.labels - orders

Połączenia z wymienionymi wyżej usługami powinny kończyć się niepowodzeniem i odpowiedzią Service was not found on the server.

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

10 sierpnia 2024 r.

Usługi Kup przez Google

W ramach wyłączenia interfejsów API usługi Kup przez Google wszystkie metody w usłudze BuyOnGoogleProgramService przestaną działać w systemie service was not found on the server.

19 lipca 2024 r.

Produkty

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

20 maja 2024 r.

Usługi dotyczące produktów

Dodano stronę LoyaltyPrograms. Ta aktualizacja umożliwia udostępnianie w przypadku jednego produktu wielu poziomów z różnymi punktami lojalnościowymi, cenami itp. Należy użyć tego pola zamiast pojedynczego pola LoyaltyProgram.

Usługa raportów

Nieużywane dane Kup przez Google w tabeli MerchantPerformanceView. Po tej aktualizacji pobieranie dowolnych danych Kup przez Google zwraca wartość 0. Dotyczy to również wartości historycznych dla dat w przeszłości.

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

13 maja 2024 r.

Usługi dotyczące produktów

Materiały dotyczące produktu

Zmiany w polu „Certyfikaty”: dodano wartość certificationValue do pola ProductCertification, aby podać wartość certyfikatu (inaczej klasę, poziom lub ocenę), która umożliwia użytkownikom przesyłanie informacji o certyfikacie, nawet jeśli urząd certyfikacji nie wydaje kodu ani numeru certyfikatu.

Więcej informacji znajdziesz w przewodnikach po usługach.

6 maja 2024 r.

Usługa raportów

Dodano zbiorczy wynik skuteczności do tabeli PriceInsightsProductView. 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ługi dotyczące produktów

Zasób produktu

Dodano opcjonalne pola downpayment i creditType dla płatności ratalnych:

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

11 kwietnia 2024 r.

Produkty

Zasób produktu

  • Dodano atrybut próg bezpłatnej dostawy (FreeShippingThreshold) na poziomie oferty. Ten atrybut pozwala sprzedawcom podać minimalną cenę produktu, aby koszt dostawy był bezpłatny.
  • Zmieniono widoczność pokoju LoyaltyPoints

10 kwietnia 2024 r.

Usługi dotyczące produktów

Zasób produktu

Dodano stronę LoyaltyProgram

9 kwietnia 2024 r.

Usługi dotyczące produktów

Zasób produktu

Dodano tagi structuredTitle i structuredDescription, aby generować tytuły i opisy produktów za pomocą AI.

3 kwietnia 2024 r.

Zespół pomocy dla sprzedawców

Dodaliśmy pole user_input_action_option, które umożliwia partnerom wysłanie żądania nowego typu działania: BuiltInUserInputAction. Dzięki temu partnerzy mogą tworzyć skomplikowane samoobsługowe funkcje obsługi sprzedawców bezpośrednio w ich aplikacjach, 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.

Produkty

Zasób produktu

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

15 marca 2024 r.

Wycofanie usługi Kup przez Google w wyszukiwarce i Zakupach Google Do 31 października 2024 r. możesz nadal wyświetlać istniejące zamówienia za pomocą orders.list i orders.get.

8 marca 2024 r.

Usługa raportów

Raport TopicTrendsView został dodany do usługi Reports.

Więcej informacji znajdziesz w przewodniku po raportowaniu.

6 marca 2024 roku

Usługa raportów

Dodano grupę i ranking potencjału kliknięć produktów.

Więcej informacji znajdziesz w przewodniku po raportowaniu.

19 lutego 2024 r.

Usługa ConversionSources

Usunęliśmy z listy prawidłowych źródeł konwersji te wartości:

  • CROSS_CHANNEL_FIRST_CLICK
  • CROSS_CHANNEL_LINEAR
  • CROSS_CHANNEL_POSITION_BASED
  • CROSS_CHANNEL_TIME_DECAY

Usunęliśmy opcje 60 i 90 dni jako okres ważności i dodaliśmy opcję 40 dni.

17 stycznia 2024 r.

Usługa punktu sprzedaży

Dodaliśmy nowe wartości pola matching_status_hint w PosStore, aby użytkownicy mogli uzyskać więcej informacji o przyczynach niepowodzenia dopasowywania sklepów.

11 stycznia 2024 r.

Usługa dotycząca kont

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

29 listopada 2023 r.

Zespół pomocy dla sprzedawców

Dodano VERIFY_IDENTITY_IN_MERCHANT_CENTER typ działania zewnętrznego w celu weryfikacji tożsamości, które należy wykonać w Merchant Center.

Usługa punktu sprzedaży

Do pól PosStore dodaliśmy pola matching_status i matching_status_hint, które informują użytkowników o stanie dopasowania sklepu – punktu sprzedaży do sklepu w Profilu Firmy w Google oraz podają wskazówkę dotyczącą rozwiązania problemu.

15 listopada 2023 r.

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

1 listopada 2023 r.

Usługa Ustawienia dostawy

shipment_type=pickup nie jest już obsługiwana.

18 października 2023 r.

Usługa dotycząca kont

Dodaliśmy pole Business Identity, które pozwala sprzedawcom na samodzielne identyfikowanie się w przypadku niektórych wartości dla konsumentów.

10 października 2023 r.

Dodano Collection Point jako nowy typ usługi ustawień dostawy. Dostawa do punktu odbioru to usługa świadczona przez firmę zewnętrzną (np.nie przez sprzedawcę), która polega na dostarczeniu produktu do miejsca należącego do firmy zewnętrznej (np. punktu dostępu UPS), a nie bezpośrednio do domu.

18 września 2023 r.

Usługa ustawień reklam lokalnego asortymentu produktów

Dodaliśmy metodę setOmnichannelExperience, aby umożliwić użytkownikom konfigurowanie wielokanałowości (tj. ustawień lokalnej witryny sklepowej i odbioru). Obecnie ta funkcja jest dostępna tylko dla użytkowników, których dostawca systemu POS jest zaufanym dostawcą.

7 września 2023 r.

Wycofanie usługi Kup przez Google

Dodanie nowego stanu DEPRECATED do metody GetBuyOnGoogleProgramStastus. Nie można ponownie aktywować ani wstrzymać programu w takim stanie.

4 września 2023 r.

Zespół pomocy dla sprzedawców

Dodano FIX_ACCOUNT_ISSUE wbudowane działanie dotyczące problemów z usługą, które należy rozwiązać na poziomie konta. Dodano wbudowaną akcję SHOW_ADDITIONAL_CONTENT, która będzie służyć do przesyłania uzasadnienia od organu państwowego.

28 sierpnia 2023 r.

Usługa promocji

Otwórz metodę list w usłudze Promotions z ograniczonym dostępem dla wszystkich.

22 sierpnia 2023 r.

Zespół pomocy dla sprzedawców

Uruchomiliśmy usługę pomocy dla sprzedawców. Ta usługa zawiera treści pomocy dotyczące problemów z kontem i usługami.

4 sierpnia 2023 r.

Usługa raportów

Dodaliśmy do usługi Raporty raport Widoczność na tle konkurencji dotyczący bezpośrednich konkurentów.

Więcej informacji znajdziesz w naszych przewodnikach dotyczących raportowania.

25 lipca 2023 r.

Usługa punktu sprzedaży

Zasoby reklamowe

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 do usługi Raporty raporty Widoczność na tle konkurencji.

Więcej informacji znajdziesz w przewodniku po raportowaniu.

7 lipca 2023 r.

Produkty

Zasób produktu

Dodaliśmy virtualModelLink, aby udostępniać adresy URL obrazów modeli 3D.

4 lipca 2023 r.

Usługi dotyczące produktów

Zasób produktu

Dodaj pole certifications, aby podać certyfikaty produktów, na przykład etykiety efektywności energetycznej produktów na podstawie bazy danych EPREL Unii Europejskiej.

26 czerwca 2023 r.

Ustawienia dostawy

Realizacja lokalna

Dodano pole no_delivery_post_cutoff, aby umożliwić sprzedawcom rezygnację z wyświetlania dostawy lokalnej w ciągu n+1 dni, jeśli 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 metodzie ReportInteraction usługi Recommendations włącz odrzucanie interakcji.

9 maja 2023 r.

Miejsce docelowe Cloud Retail

Dodatkowe właściwości Cloud Retail

Dodaj pole właściwości dodatkowych Cloud Retail. To jest powtarzalne pole przeznaczone do użytku przez klientów korzystających z miejsca docelowego Cloud Retail. Gdy to pole jest używane, będzie dostępne podczas korzystania z programu sprzedaży detalicznej w chmurze. 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.

Ustawienia dostawy

Realizacja lokalna

Dodano opcję realizacji dostawy lokalnej dla sprzedawców tworzących nowe ustawienia dostawy. W nowym polu storeConfig mogą skonfigurować ustawienia lokalnych sklepów. Obejmuje to promień usługi, termin dostawy i kody sklepów oferujących dostawę lokalną.

3 kwietnia

Usługa Rekomendacje

Udostępniono usługę rekomendacji. Ta usługa dostarcza sugerowanych sposobów na poprawę skuteczności konta sprzedawcy i pozwala raportować kliknięcia sprzedawcy związane z przydatnymi rekomendacjami.

20 lutego 2023 r.

Usługa kont

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 (znajduje się w sekcji Ustawienia konwersji w Merchant Center).

16 lutego 2023 r.

Ustawienia dostawy

Weryfikacja kodu sklepu

Przed zaktualizowaniem ustawień dostawy kody sklepów są teraz weryfikowane pod kątem przynależności do sprzedawcy.

Weryfikacja sprzedawcy w reklamach lokalnego asortymentu produktów

Zanim zaktualizujesz ustawienia dostawy, musisz teraz potwierdzić, że sprzedawca jest zarejestrowany w programach. 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

Rozszerzenie usługi Promocje o 6 dodatkowych opcji targetCountry z lokalnym wsparciem contentLanguage:

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

12 stycznia 2023 r.

Usługi dotyczące produktów

Zasób produktu

Dodano lifestyleImageLinks, aby udostępniać adresy URL zdjęć produktów w kontekście.

24 listopada 2022 r.

Usługa promocyjna

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

15 listopada 2022 r.

Usługa raportów

Dodano raporty programu Trendy rynkowe do usługi Raporty.

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

Więcej informacji znajdziesz w naszych przewodnikach dotyczących raportowania.

7 listopada 2022 r.

Usługa plików danych

Dodaliśmy obsługę usługi plików danych feedLabel.

14 września 2022 r.

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

9 sierpnia 2022 r.

Dodano feedLabel dla produktów.

Aby określić kraj dla identyfikatorów ofert, możesz teraz użyć kolumny feedLabel zamiast kolumny targetCountry. Identyfikatory ofert są teraz tworzone w ten sposób: online:language:feedLabel:offerId.

Aby zapewnić zgodność wsteczną, w przypadku dotychczasowych plików danych atrybuty feedLabel zostały automatycznie wypełnione wartością targetCountry.

Wycofano: targetCountry.

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

Parametr targetCountry jest teraz automatycznie wypełniany wartością podaną w polu feedLabel.

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

8 grudnia 2021 r.

Usługa Konta

Zasób konta

Dodaliśmy nową sekcję Account.AutomaticImprovements w zasobie Accounts.

Ta nowa sekcja pozwoli sprzedawcom automatycznie aktualizować produkty, ulepszać zdjęcia i ustawienia dostawy.

25 października 2021 r.

Usługa promocyjna

Dodano metodę Get Promotion do interfejsu Promotion API.

11 października 2021 r.

Shipping Settings API

Dodaliśmy nowe pole warehouse w zasobie ShippingSettings, aby umożliwić sprzedawcom zarządzanie magazynami, których można używać w WarehouseBasedDeliveryTime.

Dodaj nowe pole warehouseName w WarehouseBasedDeliveryTime, aby odwoływać się do magazynu po nazwie magazynu.

4 października 2021 r.

Usługa Konta

Zasób konta

Dodano nowe pole „phone_verification_status” w sekcji Accounts.BusinessInformation. To pole tylko do odczytu jest ustawiane przez funkcję Accounts.VerifyPhoneNumber.

13 września 2021 r.

usługa BuyOnGooglePrograms,

Zasób BuyOnGoogleProgramStatus

Dodaliśmy nowe pola w zasobie BuyOnGooglePrograms.BuyOnProgramStatus: kanały sprzedaży online, modele biznesowe i numer telefonu do 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

W sekcji Accounts.BusinessInformation dodaliśmy nowe pole „korean_business_registration_number”. To pole zostanie usunięte tylko wtedy, gdy zostanie ustawione jako pusty ciąg znaków.

30 sierpnia 2021 r.

Usługa promocyjna

Dodano nową usługę promocyjną z możliwością dodania insertu.

Usługa Zamówienia

Dodano nową metodę orders/captureOrder umożliwiającą pobieranie środków przed wysyłką.

Nowy powód anulowania zamówienia FAILED_TO_CAPTURE_FUNDS

Usługi dotyczące produktów

Zasób produktu

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

9 sierpnia 2021 r.

Usługa RepricingRule

Typ reguły ponownej wyceny

Nowa wartość wyliczenia dla pola RepricingRuleType.

Dodano TYPE_SALES_VOLUME_BASED i TYPE_COMPETITIVE_PRICE.

17 maja 2021 r.

Etykieta zwrotna zamówienia

Dodano nowe pole „product_id” w zapytaniu CreateReturnRequest. Sprzedawcy mogą określić identyfikator produktu za pomocą atrybutu product_id lub line_item_id, aby zidentyfikować produkt do zwrotu.

Usługi dotyczące produktów

Dodano nową metodę aktualizowania dotychczasowych produktów. Możesz zaktualizować produkt, podając tylko pola, które wymagają zmiany, zamiast całego produktu.

3 maja 2021 r.

Usługa etykiet zwrotów za zamówienie

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 zwrotu, aby udostępnić je klientowi.

26 kwietnia 2021 r.

Shipping Settings API

Nowe pole warehouseBasedDeliveryTimes w DeliveryTime, aby obsługiwać usługi dostawy, które obliczają przewidywany termin dostawy na podstawie lokalizacji magazynu i wybranej usługi przewoźnika.

Nowe pole eddServices w obiekcie CarriersCarrier służy do zwracania nazw usług, które można wykorzystać do obliczenia przewidywanej daty dostawy.

12 kwietnia 2021 r.

Usługi dotyczące produktów

Zasób produktu

Nowe pole additionalSizeType, które obsługuje maksymalnie 2 rodzaje rozmiarów na produkt.

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

28 stycznia 2021 r.

Usługa Konta

Dodano obsługę automatycznych etykiet do zasobów AccountLabel i Account. Więcej informacji znajdziesz w sekcji Typy etykiet CSS w przewodniku po zarządzaniu etykietami CSS.

5 października 2020 r.

Usługa CSSES

Zasób CSS

Dodano nową usługę csses do pobierania informacji o domenach usługi porównywania cen i przypisywania im etykiet. Zasób AccountLabel może być teraz używany również do tworzenia i wyświetlania etykiet na poziomie grupy usługi porównywania cen. Więcej informacji znajdziesz w artykule Zarządzanie etykietami CSS.

24 sierpnia 2020 r.

Usługi dotyczące produktów

Materiały dotyczące produktów

Nowe pole shoppingAdsExcludedCountries do wykluczania 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 kont

Dodaliśmy nowy zasób AccountLabel do zarządzania etykietami kont Merchant Center w CSS Center. Użytkownicy CSS Center mogą teraz 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ługi dotyczące produktów

Zasób produktu

Nowe pola

Nowe pola productDetails, productHighlights, subscriptionCost i canonicalLink.

2 czerwca 2020 r.

Usługa Zamówienia

Dodano nowe metody inicjowania zwrotów środków bez zwracania produktów. Dzięki nowym orders.refunditem i orders.refundorder możesz inicjować zwroty środków za zamówienia, nawet jeśli nie zostały one zwrócone przez klienta.

27 kwietnia 2020 r.

Usługa zwrotów

Dodano nowe metody acknowledge i process oraz nowe filtry i pola metod odczytu (list, get).

Łączenie z kontem Google Moja Firma

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

14 kwietnia 2020 r.

Interfejsy API do raportowania rozliczeń

Dodaliśmy nową usługę umożliwiającą uzyskiwanie raportów rozliczenia.

Marzec 9, 2020

Interfejs API lokalnego asortymentu

Dodano 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ługi dotyczące produktów

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

11 września 2019 r.

Usługa Zamówienia

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

14 sierpnia 2019 r.

Nowe usługi

Dodaliśmy nowe zasady zwrotów i usługi związane z adresem zwrotnym w Kup przez Google.

Usługa Zamówienia

Zasób zamówienia

Nowe pole

Nowe pole quantityUndeliverable.

7 sierpnia 2019 r.

Usługa zamówień

Zasób zamówienia

Nowe pola

Dodano nowe pola loyaltyInfo i invoiceReceivingEmail do zasobu zamówienia.

1 lipca 2019 r.

Produkty

Obsługa dodatkowych plików danych Content API dodanych w usłudze Produkty.

11 czerwca 2019 r.

Usługa Zamówienia

Zasoby związane z zamówieniami i testami zamówień

Dodanie korekty ceny

Dodaliśmy nowe pole lineItem[].adjustments, które zawiera korektę pierwotnej ceny elementu zamówienia i podatku wynikające z zastosowania promocji.

14 lutego 2019 r.

Zmiany wprowadzone w tej wersji

Próby nie są już obsługiwane

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

Metody poprawek nie są już obsługiwane

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

  • Konta
  • Accounttax
  • Pliki danych
  • Liasettings
  • Shippingsettings

Usuwanie metod HTTP BATCH

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

  • Konta
  • Stany konta
  • Pliki danych
  • Stany plików danych
  • Liasettings
  • Raporty o zamówieniach
  • Poz.
  • Produkty
  • Productstatuses
  • Ustawienia dostawy

Usługa Konta

Aktualizuj

Pola businessInformation i googleMyBusinessLink w żądaniu zostały wprowadzone po pierwszym uruchomieniu Content API w wersji 2. Stosuje się zabezpieczenie, które zapobiega przypadkowemu usunięciu informacji podanych w tych 2 polach za pomocą atrybutu update, jeśli ich nie podano.

Aby usunąć te pola, sprzedawcy muszą w wersji 2 wyraźnie podać je z pustym tekstem ( {}). W wersji 2.1 pola są usuwane, jeśli tekst jest pusty lub nie jest podany.

Zasób konta

Rebranding AdWords –> Google Ads

W związku z tym, że AdWords to Google Ads, zmieniliśmy nazwy następujących pól związanych z AdWords:

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

Wycofane pole reviewsUrl zostało usunięte. Ponadto usunięto stan połączenia inactive w przypadku zasobów adsLinks, googleMyBusinessLink i youtubeChannelLinks.

Usługa dotycząca stanu konta

Zasób AccountStatus

Usuwanie problemów z jakością danych

Zostały one zastąpione przez regułę itemLevelIssues.

Usługa pliku danych

Zasób pliku danych

Usuwanie wycofanych pól

Pola contentLanguage, targetCountry i intendedDestinations zostały usunięte i zastąpione polami country, language, includedDestinations i excludedDestinations w targets.

Usuwanie aktualizacji asortymentu produktów

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

Usługa dotycząca zasobów reklamowych

Usługa inventory w wersji 2 została usunięta i zastąpiona przez 2 nowe funkcje w wersji 2.1:

Usługa Zamówienia

CancelLineItem

Pola amount, amountPretax i amountTax z żądania zostały usunięte. Kwota zwrotu środków jest teraz obliczana automatycznie.

CustomBatch

Z wersji 2.1 usunięto element CustomBatch.

InStoreRefundLineItem

Pola amountPretax i amountTax zostały zastąpione odpowiednio przez pola priceAmount i taxAmount. Pole priceAmount może zawierać wartość przed naliczeniem podatku lub po opodatkowaniu w zależności od lokalizacji zamówienia.

Zwrot środków

Ta metoda została usunięta. Zamiast tego użyj pola returnRefundLineItem.

ReturnLineItem

Ta metoda została usunięta. Zamiast tego użyj returnRefundLineItem bez podania kwoty zwrotu środków.

ReturnRefundLineItem

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

ShipLineItem

Pola carrier, shipmentId i trackingId w żądaniu zostały przeniesione do pola shipmentInfos.

Zasoby dotyczące zamówień i zamówienia TestOrder

Nowy format promocji

W wersji 2.1 wprowadzono nowy format promocji. Nie można tworzyć zamówień testowych z promocjami.

Usuwanie wycofanych pól

Pole paymentMethod zostało usunięte, a pola billingAddress i predefinedBillingAddress są teraz polami najwyższego poziomu odpowiednio w modelach Order i TestOrder.

Ponadto w funkcjach Order i TestOrder zostały usunięte wartości customer.explicitMarketingPreference i zastąpione wartościami customer.marketingRightsInfo.

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ługi dotyczące produktów

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

  • channel
  • contentLanguage
  • id
  • offerId
  • targetCountry

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

Zanim wstawiony produkt zostanie pobrany przez get lub list, może minąć kilka minut.

Zwracany identyfikator oferty nie musi być taki sam jak podany identyfikator oferty.

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

Zasób produktu

CustomGroups zastąpione przez rekurencyjne customAttributes

W wersji 2.0 atrybuty niestandardowe można było grupować, dodając je do tej samej grupy niestandardowej. W wersji 2.1 atrybuty niestandardowe są rekurencyjne, więc nie trzeba już tworzyć grup niestandardowych.

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

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

Usunięcie typu i jednostki z atrybutów customAttributes

W wersji 2.1 atrybuty niestandardowe nie będą już zawierać wartości type ani unit. Zamiast tego do atrybutu value (jeśli jest obecny) należy dołączyć jednostki, a typy powinny być wykrywane automatycznie. Na przykład value w wersji 2.1 użyj „1,23 EUR” lub „5,6 cm”.

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 przez pojedyncze pole powtarzalne productTypes.

Atrybut Destinations został zastąpiony atrybutami includedDestinations i excludedDestinations

W wersji 2 miejsca docelowe były podawane jako lista par nazwa miejsca docelowego i intencja w powtarzalnym polu destinations. To pole zostało zastąpione przez 2 powtarzające się pola: includedDestinations i excludedDestinations. W: includedDestinations. nie musisz uwzględniać miejsc docelowych włączonych domyślnie. Będą one zgodne z konfiguracją zastąpień miejsc docelowych w plikach danych.

W związku z tym, że AdWords zmieniło nazwę 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 następujące pola:

  • aspects
  • destinations
  • onlineOnly
  • validatedDestinations
  • warnings

Usługa Productstatuses

Pobieranie i wyświetlanie listy

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ł zawsze ustawiony na true.

Zasób ProductStatus

DestinationsStatuses

Pola intention, approvalStatus i approvalPending w destinationStatuses zostały zastąpione przez pole status, które jest ciągiem znaków, który może być approved, disapproved lub pending.

Usuwanie problemów z jakością danych

Zostały one zastąpione przez itemLevelIssues.