Informacje o wersji (v2.1)

15 listopada 2024 r.

Usługi dotyczące produktów

W przypadku LoyaltyProgram dodano pole shipping_label, aby określić, czy dana usługa kwalifikuje się do korzystania z tej funkcji. Jeśli pole zawiera wartość, oznacza to, że oferta kwalifikuje się do korzyści związanych z dostawą w programie lojalnościowym. Jeśli wartość pola nie zostanie podana, produkt nie kwalifikuje się do dostawy w ramach programu lojalnościowego na danym poziomie.

30 października 2024 r.

W ramach wyłączenia interfejsów API związanych z rozliczeniami wycofujemy te 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.

W przypadku wywołań tych usług powinna być zwracana odpowiedź 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 zamykania interfejsów API usługi Kup przez Google wszystkie metody w interfejsie BuyOnGoogleProgramService będą się kończyć niepowodzeniem z wartością service was not found on the server.

19 lipca 2024 r.

Usługi dotyczące produktów

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 dla 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 z danych dni.

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

13 maja 2024 r.

Usługi dotyczące produktów

Zasób produktu

Zmiany w polu certyfikaty: dodano pole certificationValue do pola ProductCertification w celu podania wartości certyfikatu (znanej też jako klasa, poziom lub ocena), co pozwala użytkownikom przesyłać informacje o certyfikacie, nawet jeśli instytucja certyfikująca nie wydaje kodu lub 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.

Usługi dotyczące produktów

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

Dodano pole user_input_action_option, które umożliwia partnerom żądanie nowego typu działania: BuiltInUserInputAction. Dzięki temu partnerzy mogą tworzyć złożone funkcje samoobsługi dla sprzedawców bezpośrednio w 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ługi dotyczące produktów

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

Do usługi Reports dodano raport TopicTrendsView.

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 na potrzeby 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 określenie niektórych wartości dla konsumentów.

10 października 2023 r.

Dodano Collection Point jako nowy typ przesyłki w ustawieniach dostawy. Dostawa do punktu odbioru to usługa świadczona przez firmę zewnętrzną (np.nie będącą własnością sprzedawcy), która dostarcza produkt do miejsca powiązanego z firmą zewnętrzną (np. do 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, aby umożliwić użytkownikom konfigurowanie wrażeń z zakupów wielokanałowych (czyli ustawień lokalnego sklepu 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 przewodniku po raportowaniu.

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.

Usługi dotyczące produktów

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, np. etykiety efektywności energetycznej produktów na podstawie bazy danych EPREL Unii Europejskiej.

26 czerwca 2023 r.

Usługa 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 dodatkowych właściwości usługi 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ą konfigurować ustawienia lokalnych sklepów. Obejmuje to promień usługi, termin dostawy i kody sklepów oferujących dostawę lokalną.

3 kwietnia

Usługa Rekomendacje

Uruchomiono usługę rekomendacji. Ta usługa zawiera sugestie dotyczące zwiększania skuteczności konta sprzedawcy oraz umożliwia zgłaszanie kliknięć przez sprzedawcę 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 (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ą być zarejestrowani 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 umożliwić podanie adresów 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

Dodaliśmy raporty 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 przewodniku po raportowaniu.

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 zalecamy użycie pola shipping do określenia krajów docelowych.

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 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

Dodano nowe pole „korean_business_registration_number” w sekcji Accounts.BusinessInformation. To pole zostanie wyczyszczone 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 zmiany ceny

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.

Etykieta zwrotna zamówienia

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 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żna teraz też używać 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

Zasoby produktów

Nowe pole shoppingAdsExcludedCountries do wykluczania ofert z reklamy 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 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 opcjom orders.refunditem i orders.refundorder możesz inicjować zwroty środków za zamówienia nawet wtedy, gdy klient ich nie zwraca.

27 kwietnia 2020 r.

Usługa zwrotów

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

Łączenie z 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 raportów rozliczeń

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

9 marca 2020 r.

Interfejs API lokalnego asortymentu

Dodano nową usługę przesyłania danych o lokalnym asortymencie.

2 marca 2020 r.

Pubsub notification settings API

Dodano 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ę dostawy do odbioru w przypadku zamówień i odpowiednich funkcji piaskownicy.

14 sierpnia 2019 r.

Nowe usługi

Dodano nowe zasady zwrotów i adres zwrotny dla usługi Kup przez Google.

Usługa Zamówienia

Zasób zamówienia

Nowe pole

Nowe pole quantityUndeliverable.

7 sierpnia 2019 r.

Usługa Zamówienia

Zasób zamówienia

Nowe pola

Do zasobu zamówienia dodano nowe pola loyaltyInfo i invoiceReceivingEmail.

1 lipca 2019 r.

Usługi dotyczące produktów

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

Dodano nowe pole lineItem[].adjustments, które zawiera korektę pierwotnej ceny pozycji na linii oraz podatku spowodowaną zastosowaniem 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 customBatch. Usługi, na które ma to wpływ:

  • Konta
  • Stany kont
  • Pliki danych
  • Stany plików danych
  • Liasettings
  • Orderreports
  • Poz.
  • Produkty
  • Productstatuses
  • Shippingsettings

Usługa Konta

Aktualizuj

Pola businessInformation i googleMyBusinessLink w żądaniu zostały wprowadzone po pierwszym uruchomieniu Content API w wersji 2. Dlatego wprowadziliśmy zabezpieczenie, które uniemożliwia sprzedawcom niezamierzone usunięcie informacji z tych 2 pol, jeśli nie są one podane.update

W wersji 2 sprzedawcy muszą wyraźnie podać te pola z pustym tekstem ( {}), aby je usunąć. 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 zmieniło nazwę 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. 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 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 w żądaniu zostały usunięte. Kwota zwrotu środków jest teraz obliczana automatycznie.

CustomBatch

Element CustomBatch został usunięty z wersji 2.1.

InStoreRefundLineItem

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.

Zwrot środków

Ta metoda została usunięta. Zamiast tego użyj 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ć wartość przed opodatkowaniem 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 związane z zamówieniami i testami zamówień

Nowy format promocji

W wersji 2.1 jest dostępny nowy format promocji. Nie możesz 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 elementach 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 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.

Obecnie może minąć kilka minut, zanim wstawiony produkt będzie można pobrać za pomocą funkcji get lub list.

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). Przecinek nie jest już akceptowany.

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. Musisz ustawić dokładnie jedno z tych pól, co oznacza, że nie mogą być one ustawione ani pominięte jednocześnie.

Ponieważ sprzedawcy mogą przełączać się między wersją 2.0 a 2.1, produkty mogą mieć rekurencyjne atrybuty niestandardowe, które nie mogą być reprezentowane w wersji 2.0, ponieważ grupy niestandardowe mogą mieć maksymalnie 2 poziomy. W takim przypadku grupa niestandardowych atrybutów zostanie obcięta.

Usunięcie typu i jednostki 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 w wersji 2.1 użyj wartości value „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. Miejsca docelowe włączone domyślnie nie muszą być uwzględniane w pliku includedDestinations.. Odpowiada to konfiguracji 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 wypisywanie na liście

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.