18 sierpnia 2025 r.
Interfejs Content API został wycofany i zostanie wyłączony w sierpniu 2026 r. Przejdź na Merchant API
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 (MRP) 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.
17 marca 2025 r.
Usługi związane z zamówieniami
W ramach wyłączenia interfejsów API związanych z zamówieniami wycofaliśmy te usługi:
accounts.verifyphonenumberreturnpolicy
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 ProductIssue i AccountIssue.
Wycofane pola alternate_dispute_resolution z RenderProductIssuesResponse i RenderAccountIssuesResponse.
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 to pole ma wartość, ta oferta obejmuje korzyść w postaci dostawy w ramach programu lojalnościowego. Jeśli wartość pola nie zostanie podana, produkt nie kwalifikuje się do dostawy dla członków programu lojalnościowego na danym poziomie lojalnościowym.
30 października 2024 r.
Usługi związane z rozliczeniami
W ramach wyłączenia interfejsów API związanych z rozliczeniami te usługi zostaną wycofane:
settlementreportssettlementtranscations
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 podawaliśmy)
Usługi związane z zamówieniami
W ramach wyłączenia interfejsów API związanych z zamówieniami wycofaliśmy te usługi:
orderinvoicesorderreportsorderreturnsorderreturns.labelsorders
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 przez 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, jeśli ma zastosowanie, 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 będzie zawsze obowiązywać.
20 maja 2024 r.
Usługa dotycząca produktów
Dodano LoyaltyPrograms.
Ta aktualizacja umożliwia podanie kilku 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 rodzaje danych Kup przez Google w tabeliMerchantPerformanceView. 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 urząd certyfikacji nie wydaje kodu ani numeru certyfikatu.
Więcej informacji znajdziesz w przewodnikach po produktach.
6 maja 2024 r.
Usługa raportów
Dodano przedział 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ługa dotycząca produktów
Zasób produktu
Dodano opcjonalne pola downpayment i creditType dla płatności ratalnych:
downpaymentpodaje kwotę, którą kupujący musi zapłacić z góry w ramach płatności jednorazowej.creditTypepodaje typ płatności ratalnej (financelublease). 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 podawać tytuły i opisy produktów generowane przez AI.
3 kwietnia 2024 r.
Usługa pomocy dla sprzedawców
Dodaliśmy pole user_input_action_option, które umożliwia partnerom przesyłanie 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ę o dodanie do listy dozwolonych w formularzu pomocy dotyczącej interfejsu Shopping API w sekcji „What is the issue/question?” (Jaki jest problem lub pytanie?).
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.list i orders.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_CLICKCROSS_CHANNEL_LINEARCROSS_CHANNEL_POSITION_BASEDCROSS_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 polu matching_status_hint w tabeli PosStore, dzięki czemu użytkownicy mogą uzyskać więcej informacji o tym, dlaczego dopasowanie ich sklepu nie powiodło się.
11 stycznia 2024 r.
Usługa kont
Dodaliśmy 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 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 repricingrules i repricingrules.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.
Dodano Collection Point jako nowy typ dostawy 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ń wielokanałowych (czyli ustawień lokalnej witryny sklepowej i odbioru). Obecnie ta funkcja jest dostępna tylko dla użytkowników, których dostawca systemu punktu sprzedaży 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 z ograniczonym dostępem dla wszystkich.
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 usługami.
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
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 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
Dodaliśmy metodę list do 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
Dodaliśmy metodę list do 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, ostateczny termin i kody sklepów oferujących dostawę lokalną.
3 kwietnia
Usługa rekomendacji
Uruchomiliśmy 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 sprzedawcy w reklamach lokalnego asortymentu produktów
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_GOOGLELOCAL_INVENTORY_ADS
9 lutego 2023 r.
Usługa promocji
Rozszerzenie usługi Promocje o 6 dodatkowychtargetCountry
opcji z obsługącontentLanguage
lokalną:
BRESNLJPITKR
12 stycznia 2023 r.
Usługa dotycząca produktów
Zasób produktu
Dodano 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:
- Raporty o bestsellerach
z tabelami
BestSellersProductClusterViewiBestSellersBrandView. - Raport o konkurencyjności cenowej
w tabeli
PriceCompetitivenessProductView. - Raport na temat statystyk dotyczących cen w formie
PriceInsightsProductViewtabeli.
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ł automatycznie wypełniony 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 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
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ą.
Nowy powód anulowania 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ść typu wyliczeniowego w polu RepricingRuleType.
Dodano: TYPE_SALES_VOLUME_BASED i TYPE_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 AccountLabel i Account. 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 usługi porównywania cen
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 wykluczanie 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, subscriptionCost i canonicalLink.
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 produktu.
27 kwietnia 2020 r.
Usługa Orderreturns
Dodaliśmy nowe metody acknowledge i process oraz nowe filtry i pola dla metod odczytu (list, get).
Łączenie z GMF
Dodaliśmy możliwość łączenia kont Merchant Center z kontem GMF za pomocą identyfikatora konta GMF.
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
Dodano nowe pola loyaltyInfo i invoiceReceivingEmail 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 elementu zamówienia 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 interfejsu Content API w wersji 2. Dlatego istnieje zabezpieczenie, które zapobiega przypadkowemu usunięciu informacji w tych 2 polach 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:
adwordsLinks->adsLinksadwordsLinks.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, googleMyBusinessLink i youtubeChannelLinks.
Usługa Accountstatuses
Zasób AccountStatus
Usuwanie elementu dataQualityIssues
Zostały one zastąpione przez itemLevelIssues.
Usługa kanału 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 2 nowymi funkcjami w wersji 2.1:
- Używaj nowych dodatkowych plików danych do częściowych aktualizacji produktów.
- Użyj nowego
localinventoryserwisu do aktualizacji produktów dostępnych lokalnie.
Usługa zamówień
CancelLineItem
Pola amount, amountPretax i amountTax w żądaniu zostały usunięte. Kwota zwrotu 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 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 amountPretax i amountTax zostały zastąpione odpowiednio polami priceAmount i taxAmount. Pole priceAmount może zawierać kwotę 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 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 billingAddress i predefinedBillingAddress są teraz polami najwyższego poziomu odpowiednio w Order i TestOrder.
Ponadto parametr customer.explicitMarketingPreference został usunięty i zastąpiony parametrem customer.marketingRightsInfo w funkcjach Order 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:
channelcontentLanguageidofferIdtargetCountry
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.
Od momentu wstawienia produktu do momentu, w którym można go pobrać za pomocą get lub list, upływa 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 znaków wartości dozwolone są tylko te znaki: +, -, . i cyfry (0–9). 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 już 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 type i unit. Zamiast tego jednostki należy dołączyć do wartości 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 pola 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 polu powtarzanym destinations. To pole zostało zastąpione tymi 2 powtórzonymi polami: includedDestinations i excludedDestinations. Miejsca docelowe włączone domyślnie nie muszą być uwzględniane w includedDestinations.. Będzie to zgodne z konfiguracją zastąpień miejsc docelowych w plikach danych.
Zmiana nazw pól związanych z AdWords
W związku ze zmianą nazwy AdWords na Google Ads zmieniliśmy nazwy tych pól związanych z AdWords:
adwordsGrouping->adsGroupingadwordsLabels->adsLabelsadwordsRedirect->adsRedirect
Usuwanie wycofanych pól
Usunęliśmy te wycofane pola:
aspectsdestinationsonlineOnlyvalidatedDestinationswarnings
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, approvalStatus i approvalPending w destinationStatuses 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.