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 accounttax
została wycofana.
Mar 17, 2025
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.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 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 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.
Usługi związane z rozliczeniami
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)
Usługi związane z zamówieniami
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 MerchantPerformanceView
tabeli. 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 downpayment
i creditType
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
lublease
). 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.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_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 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.
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_CONTENT
wbudowane 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:
- Raporty o bestsellerach
z tabelami
BestSellersProductClusterView
iBestSellersBrandView
. - Raport o konkurencyjności cenowej
w tabeli
PriceCompetitivenessProductView
. - Raport na temat statystyk dotyczących cen
z użyciem
PriceInsightsProductView
tabeli.
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_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 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
, 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 produktów.
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 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 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 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:
adwordsLinks
->adsLinks
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
, googleMyBusinessLink
i youtubeChannelLinks
.
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
, 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 Inventory Service
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 serwisu
localinventory
do aktualizacji produktów dostępnych lokalnie.
Usługa zamówień
CancelLineItem
Pola amount
, amountPretax
i amountTax
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 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
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 (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 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 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: includedDestinations
i excludedDestinations
. 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.
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
->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
, 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
.