NowośćProduct Score, 4T Segmentation, Price War i Broken Size są już dostępne.Zobacz, co nowego
Feedance
Artykuł

Jak naprawić błędy 410 Content API od Google: migracja procesu obsługi feedu do Merchant API

Content API for Shopping zwraca błędy 410. Znajdź pozostałe wywołania, przypisz je do Merchant API, utwórz źródło danych i sprawdź produkty w Merchant Center.

Cagdas PolatCagdas Polat
8 minut czytania
Jak naprawić błędy 410 Content API od Google: migracja procesu obsługi feedu do Merchant API

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łaWłaścicielDziałanie
Wtyczka sklepuPełny katalog, codziennieDostawca platformyZapytaj, której wersji API obecnie używa
Skrypt stanów magazynowychCeny i stany, co godzinęTwój deweloperMigracja do Merchant API
Narzędzie do zarządzania feedamiZoptymalizowany feedDostawca narzędziaPoproś 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 APIMerchant APICo się zmienia
products.insertproductInputs.insertWymaga parametru zapytania dataSource
products.updateproductInputs.patchTrwała aktualizacja jednego wejścia produktu
products.deleteproductInputs.deleteWymaga parametru dataSource
products.get / listproducts.get / listZwraca przetworzony produkt, tylko do odczytu
productstatuses.get / listproducts.get / listStatus jest teraz częścią zasobu Product
custombatchRównoległe wywołania asynchroniczneNie istnieje metoda customBatch
datafeedsdataSourcesKaż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.

Chcesz, by ktoś jeszcze spojrzał na twój feed? Przejrzymy go razem z tobą i pokażemy luki przed kolejnym przesłaniem.
Zrób bezpłatny audyt
Cagdas Polat
Autor
Cagdas Polat

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

Zobacz, które
produkty zarabiają.

Połącz swój feed i GA4. Pokażemy Product Score, 4T, Price War i Broken Size na twoim własnym katalogu.