Content API for Shopping od Google został wygaszony 18 sierpnia 2026 roku. Od 1 września żądania z projektów bez zatwierdzonego przedłużenia sporadycznie kończą się błędem HTTP 410, a na początku 2027 roku endpointy zostaną całkowicie wyłączone (komunikat Google o wygaszeniu). Jeśli jakiś skrypt, wtyczka lub wewnętrzny konektor wciąż przesyła twoje produkty do Merchant Center przez stare API, część tych aktualizacji już przepada.
Ten przewodnik jest dla deweloperów i właścicieli feedów, którzy sami utrzymują taki proces. Po jego lekturze będziesz w stanie znaleźć każde pozostałe wywołanie Content API, przypisać każde z nich do odpowiednika w Merchant API, utworzyć źródło danych wymagane przez nowe API i potwierdzić w Merchant Center, że produkty i ceny nadal docierają.
Jak sprawdzić, czy dotyczy cię wygaszenie
Błąd łatwo przeoczyć, bo występuje sporadycznie. Google dokumentuje treść błędu jako 410 z komunikatem zaczynającym się od „Content API for Shopping was sunset on August 18, 2026”, który zawiera identyfikator projektu Google Cloud, numer projektu i link do centrum pomocy. Przeszukaj logi integracji pod kątem tego ciągu oraz shoppingcontent.googleapis.com.
Zanim ktokolwiek zajrzy do logów, zwykle pojawiają się trzy objawy:
- Zmiany cen lub dostępności docierają do Google z kilkugodzinnym opóźnieniem albo tylko przy niektórych przebiegach.
- Codzienne zadanie zgłasza sukces dla większości partii, a dla kilku błąd.
- Merchant Center pokazuje nieaktualne dane, podczas gdy twój sklep pokazuje prawidłową cenę.
Ostatni objaw może mieć też drugą przyczynę – automatyczne aktualizacje produktów Google nadpisujące twoje wartości. Omawiamy to osobno w artykule o tym, jak powstrzymać Google przed cichym nadpisywaniem ceny i dostępności w feedzie. Najpierw wyklucz błędy 410, bo ich potwierdzenie jest tańsze.
Krok 1: Zinwentaryzuj każde wywołanie starego API
Google zaleca przejrzenie kodu aplikacji pod kątem bezpośrednich wywołań endpointów Content API. W praktyce wywołania ukrywają się w czterech miejscach: we wtyczce Google platformy sklepu, w niestandardowym skrypcie napisanym przez poprzedniego dewelopera, w middleware do feedów lub ERP oraz w skrypcie Google Ads lub Apps Script, który ktoś zaplanował lata temu.
Przygotuj krótki rejestr z jednym wierszem na każde źródło wywołań. Zapisz, co robi, za pomocą którego projektu Google Cloud się uwierzytelnia i kto jest jego właścicielem. Identyfikator projektu ma znaczenie, ponieważ przedłużenia i komunikat 410 są z nim powiązane.
| Źródło wywołań | Co wysyła | Właściciel | Działanie |
|---|---|---|---|
| Wtyczka sklepu | Pełny katalog, codziennie | Dostawca platformy | Zapytaj, której wersji API obecnie używa |
| Skrypt stanów magazynowych | Ceny i stany, co godzinę | Twój deweloper | Migracja do Merchant API |
| Narzędzie do zarządzania feedami | Zoptymalizowany feed | Dostawca narzędzia | Poproś o pisemne potwierdzenie migracji |
Jeśli połączeniem zarządza dostawca, twoim zadaniem jest zapytać, a nie przebudowywać. Productsup i Feedonomics opublikowały opisy migracji, a dojrzały dostawca ma ją już za sobą. Zadaj każdemu dostawcy z listy to samo pytanie i zachowaj odpowiedzi.
Krok 2: Zdecyduj, czy potrzebujesz przedłużenia
Google udostępnia formularz wniosku o przedłużenie Content API dla organizacji, które potrzebują więcej czasu. Zatwierdzone przedłużenie chroni projekt przed zaplanowanymi odpowiedziami z błędem w zatwierdzonym okresie, ale nie wykracza poza ostateczne wyłączenie na początku 2027 roku. Google nie podaje, kto się kwalifikuje.
Zastosuj taką regułę decyzyjną. Jeśli każde źródło wywołań można zmigrować i przetestować w ciągu kilku tygodni, pomiń przedłużenie i poświęć ten czas na migrację. Jeśli źródło wywołań należy do dostawcy z potwierdzoną, ale niezaplanowaną migracją, złóż wniosek o przedłużenie tylko dla tego projektu. Przedłużenie to bufor, a nie plan.
Krok 3: Przypisz każde wywołanie do odpowiednika w Merchant API
Merchant API dzieli stary monolit na pod-API i wersjonuje adres URL (/products/v1/). Wersja v1 osiągnęła ogólną dostępność w lipcu 2025 roku, a v1beta została wygaszona 28 lutego 2026 roku, więc buduj na v1 i ignoruj znalezione samouczki dla v1beta (informacje o wydaniach Merchant API).
| Content API | Merchant API | Co się zmienia |
|---|---|---|
products.insert | productInputs.insert | Wymaga parametru zapytania dataSource |
products.update | productInputs.patch | Trwała aktualizacja jednego wejścia produktu |
products.delete | productInputs.delete | Wymaga parametru dataSource |
products.get / list | products.get / list | Zwraca przetworzony produkt, tylko do odczytu |
productstatuses.get / list | products.get / list | Status jest teraz częścią zasobu Product |
custombatch | Równoległe wywołania asynchroniczne | Nie istnieje metoda customBatch |
datafeeds | dataSources | Każde źródło danych dotyczy jednej etykiety feedu i jednego języka |
Źródło: mapowanie migracji produktów i mapowanie źródeł danych od Google. Zmiana koncepcyjna polega na rozdzieleniu ProductInput, czyli surowych danych, które zapisujesz, od Product, czyli przetworzonego wyniku, który możesz tylko odczytać. Przetworzony produkt powstaje z jednego wejścia podstawowego oraz ewentualnych wejść uzupełniających po zastosowaniu reguł feedu (przegląd produktów).
Krok 4: Utwórz źródło danych API, zanim cokolwiek wstawisz
To krok, na którym wykłada się większość pierwszych migracji. Content API automatycznie tworzyło źródło danych „Content API” przy pierwszym wstawieniu. Merchant API tego nie robi. Google stwierdza, że musisz utworzyć co najmniej jedno źródło danych typu API, a pod-API Products może zapisywać tylko do źródeł danych tego typu (migracja źródeł danych).
Każde źródło danych odpowiada teraz jednej kombinacji feedLabel i contentLanguage. Jeśli z jednego feedu z wieloma celami obsługiwałeś Turcję po turecku i ZEA po angielsku, potrzebujesz teraz osobnych źródeł danych. Utwórz je przez pod-API Data Sources lub w Merchant Center, a następnie przy każdym zapisie używaj wynikowej nazwy zasobu w postaci accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}.
Krok 5: Przepisz payload – na przykładzie
Większość błędów powodują trzy zmiany pól. Cena zmienia się z ciągu dziesiętnego na liczbę całkowitą w mikrojednostkach (micros), gdzie milion mikrojednostek to jedna jednostka waluty. Atrybuty produktu przenoszą się do obiektu productAttributes. A targetCountry zostaje zastąpione przez feedLabel, przy czym channel znika.
Stary identyfikator produktu wyglądał tak, a nowy używa tyld i pomija kanał:
Content API: online:en:US:SKU12345
Merchant API: en~US~SKU12345
Wejście produktu, którego Google używa jako przykładu we własnym przewodniku, wygląda tak (wstawiane za pomocą POST https://merchantapi.googleapis.com/products/v1/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource=accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}):
{
"offerId": "SKU12345",
"contentLanguage": "en",
"feedLabel": "US",
"productAttributes": {
"title": "Classic Cotton T-Shirt",
"link": "https://www.example.com/p/SKU12345",
"imageLink": "https://www.example.com/img/SKU12345.jpg",
"availability": "IN_STOCK",
"price": { "amountMicros": "15990000", "currencyCode": "USD" },
"condition": "NEW",
"gtins": ["9780007350896"]
}
}
Porównaj to ze starą strukturą: "price": {"value": "15.99", "currency": "USD"} zmienia się w amountMicros i currencyCode, a dostępność staje się wartością wyliczeniową (enum), więc in stock zmienia się w IN_STOCK. Źródło: przewodnik Google o dodawaniu produktów i zarządzaniu nimi.
W przypadku lir tureckich 1 249,90 TRY to "amountMicros": "1249900000". Obliczaj mikrojednostki za pomocą arytmetyki całkowitoliczbowej na jednostce podrzędnej waluty, a nie przez mnożenie liczby zmiennoprzecinkowej – inaczej wyślesz 1249899999 i będziesz się zastanawiać, dlaczego ceny różnią się o włos.
Używaj też nowego pola versionNumber, gdy kilka zadań zapisuje ten sam produkt. Zapobiega ono nadpisaniu nowszej aktualizacji przez starszą, gdy żądania docierają w złej kolejności.
Krok 6: Zastąp przetwarzanie wsadowe i odczytuj status z produktu
Nie ma customBatch. Zastąp je równoległymi żądaniami asynchronicznymi z ograniczeniem współbieżności i ponawiaj tylko te, które się nie powiodły. Prowadź log wyników dla każdej oferty, aby częściowa awaria nie zamieniła się po cichu w nieaktualny katalog.
Jeśli chodzi o status, przestań wywoływać productstatuses. Zamiast tego odczytuj przetworzony Product, który zawiera swój status. Google zaznacza, że między wstawieniem lub aktualizacją a udostępnieniem ostatecznego produktu może minąć kilka minut, więc odczyt bezpośrednio po zapisie nie jest testem awarii.
Krok 7: Zweryfikuj, zanim wyłączysz starą ścieżkę
Najpierw uruchom nową ścieżkę na małym wycinku o niskim ryzyku, np. 50 produktach w jednej etykiecie feedu. Następnie oceń przełączenie według tej listy kontrolnej. Zanim wycofasz stare źródło wywołań, przy każdym punkcie powinno być „tak”.
- Źródło wywołań uwierzytelnia się w zarejestrowanym przez ciebie projekcie i przez siedem kolejnych dni nie zwraca błędu 410.
- Dla każdej obsługiwanej pary etykiety feedu i języka istnieje źródło danych API.
- W wycinku testowym przetworzony produkt zgadza się z twoim źródłem prawdy pod względem ceny, dostępności i linku.
- Nic innego nie zapisuje już tych samych identyfikatorów ofert ze starego źródła danych.
- Nieudane oferty są logowane i ponawiane, a nie porzucane.
- Wszystkie źródła wywołań zarządzane przez dostawców z twojego rejestru mają pisemne potwierdzenie migracji.
Czwarty punkt zasługuje na uwagę. Drugi zapisujący dla tego samego identyfikatora oferty, np. stare źródło wywołań i nowe źródło danych API, to prosta droga do sprzecznych wartości. Zdecyduj, które źródło jest właścicielem każdego produktu, i usuń drugie.
Gdzie ten przewodnik nie wystarcza
Napisaliśmy go na podstawie opublikowanej dokumentacji Google i nie migrowaliśmy twojego kodu. Kilka rzeczy wykracza poza jego zakres. Google nie podaje kryteriów przyznawania przedłużeń, więc nie możemy powiedzieć, czy dany projekt zostanie zatwierdzony. Przegląd produktów nie dokumentuje czasu przetwarzania poza „kilkoma minutami”, więc ewentualne surowsze oczekiwania dotyczące opóźnień musisz zmierzyć sam. Lokalne zasoby reklamowe, regionalne stany magazynowe, promocje i opinie mają w Merchant API własne zasoby podrzędne i nie omawiamy tu ich mapowania.
Jeśli w ogóle nie chcesz utrzymywać integracji z API, lepszym rozwiązaniem niż przepisywanie kodu jest zarządzana platforma do feedów. Productsup i Feedonomics publikują wskazówki dotyczące migracji do Merchant API, a dla zespołu enterprise z nietypowymi modelami danych każda z nich może pasować lepiej niż nasze rozwiązanie. W przypadku Google Shopping nasze rozwiązanie opisuje strona integracji z Google Merchant Center.
Najczęściej zadawane pytania
Czy Content API for Shopping nadal działa?
Nie w sposób niezawodny. Google podaje, że zostało wygaszone 18 sierpnia 2026 roku, że od 1 września 2026 roku żądania bez aktywnego przedłużenia zaczęły sporadycznie kończyć się błędem HTTP 410 i że wszystkie endpointy zostaną wyłączone na początku 2027 roku.
Co mówi komunikat błędu 410 Content API?
Komunikat zaczyna się od „Content API for Shopping was sunset on August 18, 2026”. Odpowiedź zawiera identyfikator projektu GCP, numer projektu i link do centrum pomocy, co mówi ci, który projekt trzeba zmigrować lub dla którego złożyć wniosek o przedłużenie.
Czy mogę dostać więcej czasu dzięki przedłużeniu?
Google udostępnia formularz wniosku o przedłużenie Content API. Zatwierdzone przedłużenie chroni projekt przed zaplanowanymi błędami tylko w zatwierdzonym okresie i nie wykracza poza wyłączenie na początku 2027 roku.
Dlaczego productInputs.insert wymaga dataSource?
Zapisy w Merchant API należą do jawnie wskazanego źródła danych. W przeciwieństwie do starego API nie tworzy ono źródła danych „Content API” przy pierwszym wstawieniu, więc musisz utworzyć źródło danych typu API i przekazać jego nazwę zasobu.
Jak przesyłać ceny w Merchant API?
Używaj amountMicros jako ciągu z liczbą całkowitą oraz currencyCode w formacie ISO 4217. Milion mikrojednostek to jedna jednostka waluty, więc 15,99 USD to 15990000.
Czy Merchant API obsługuje przetwarzanie wsadowe?
Nie ma metody customBatch. Google zaleca asynchroniczne wywołania równoległe, co oznacza, że powinieneś dodać własny limit współbieżności i ponawianie dla każdej oferty.
Co stało się z productstatuses?
Status jest teraz częścią przetworzonego zasobu Product. Odczytuj go za pomocą products.get lub products.list, pamiętając, że przetwarzanie może następować kilka minut po wstawieniu.
Na której wersji Merchant API powinienem budować?
Buduj na v1, która osiągnęła ogólną dostępność w lipcu 2025 roku. Wersja v1beta została wygaszona 28 lutego 2026 roku, więc samouczki napisane dla niej nie zadziałają.
Sprawdź, co faktycznie widzi Google
Po migracji najszybszym testem kontrolnym jest porównanie feedu źródłowego z tym, co przetworzył Merchant Center. Przepuść swój aktualny feed przez nasze bezpłatne narzędzie do audytu feedu produktowego, aby uzyskać ocenę kompletności i jakości, i napraw wszystko, co wskaże, przed kolejnym cyklem reklamowym.

Współzałożyciel Feedance, gdzie wykorzystuje swoje doświadczenie jako inżynier komputerowy i marketer, aby dostarczać analityczne wnioski. Skupia się na przekształcaniu danych w konkretne strategie i pomaga markom osiągać znaczący wzrost w świecie cyfrowym.
LinkedIn


















