wycofanie i wycofanie

18 sierpnia 2026 r. oficjalnie zakończyliśmy wycofywanie interfejsu Google Content API for Shopping. Wszyscy deweloperzy muszą jak najszybciej przenieść dotychczasowe integracje do Merchant API.

Aby zachęcić do migracji przed całkowitym wycofaniem usługi i zapewnić, że deweloperzy będą zwracać uwagę na powiadomienia o wycofywaniu w logach aplikacji, Google rozpocznie stopniowe ograniczanie działania usługi 1 września 2026 r..

Harmonogram wycofywania

W tabeli poniżej znajdziesz harmonogram stopniowego ograniczania działania i ostatecznego wycofania interfejsu Google Content API for Shopping (wersja 2.1):

Data Milestone Szczegóły
1 września 2026 r. Wprowadzenie sporadycznych nieudanych żądań Żądania bez aktywnego rozszerzenia będą sporadycznie kończyć się niepowodzeniem z kodem HTTP 410 Gone.
Początek 2027 r. Wycofywanie Całkowite wyłączenie. Wszystkie punkty końcowe zostaną wyłączone, a wszystkie żądania będą kończyć się niepowodzeniem.

Ograniczanie działania usługi i odpowiedzi w sytuacjach błędu

Od 1 września 2026 r. żądania wysyłane do punktów końcowych Google Content API for Shopping przez klientów bez aktywnego rozszerzenia będą sporadycznie kończyć się niepowodzeniem z HTTP 410 Gone kodem stanu.

Format odpowiedzi w sytuacji błędu

Gdy żądanie zostanie odrzucone w ramach zaplanowanego ograniczenia działania usługi, interfejs API zwróci ładunek błędu HTTP 410 Gone zawierający komunikat i metadane z informacjami o projekcie Google Cloud:

{
  "error": {
    "code": 410,
    "message": "Content API for Shopping was sunset on August 18, 2026 for GCP project with id YOUR_PROJECT_ID and number 123456789012. Please migrate to the Merchant API v1 version. See https://developers.google.com/merchant/api/guides/compatibility for more details",
    "status": "ABORTED",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.ErrorInfo",
        "reason": "content_api_sunset",
        "domain": "shoppingcontent.googleapis.com",
        "metadata": {
          "GCP_ID": "YOUR_PROJECT_ID",
          "GCP_NUMBER": "YOUR_PROJECT_NUMBER",
          "HELP_CENTER_LINK": "https://developers.google.com/merchant/api/guides/compatibility"
        }
      }
    ]
  }
}

Odpowiedź w sytuacji błędu zawiera te pola metadanych:

  • GCP_ID: identyfikator projektu Google Cloud, który wysyła żądanie.
  • GCP_NUMBER: unikalny identyfikator numeryczny projektu w chmurze Google Cloud.
  • HELP_CENTER_LINK: bezpośredni link do dokumentacji migracji.

Wpływ na limit

Sztuczne odpowiedzi w sytuacjach błędu generowane podczas ograniczania działania usługi nie są wliczane do limitu interfejsu API projektu.

Ponawianie nieudanych żądań

Ponieważ początkowe ograniczenie działania usługi powoduje, że tylko część żądań kończy się niepowodzeniem, ponowienie nieudanego żądania może się powieść. Jednak poleganie na ponawianiu nie jest długoterminowym rozwiązaniem, ponieważ liczba nieudanych żądań będzie się zwiększać, aż do momentu, gdy wszystkie żądania będą kończyć się niepowodzeniem po wycofaniu usługi.

Deweloperzy, których to dotyczy

Proces wycofywania i ograniczania działania usługi dotyczy deweloperów i firm w następujący sposób:

  • Integracje z niestandardowym interfejsem API: jeśli Twoja organizacja utrzymuje wewnętrzne narzędzia, skrypty lub oprogramowanie niestandardowe, które bezpośrednio wywołuje interfejs Google Content API for Shopping, musisz zaktualizować aplikacje, aby wywoływały Merchant API.
  • Platformy innych firm: jeśli uzyskujesz dostęp do Merchant Center za pomocą platformy e-commerce, partner platformy zarządza migracją w Twoim imieniu. Nie musisz nic robić.

Wymagane działanie

Aby zapobiec przerwom w wyświetlaniu ofert produktów i zarządzaniu kontem:

  1. Zapoznaj się z omówieniem Merchant API, aby poznać architekturę, uwierzytelnianie i struktury sub-API.
  2. Postępuj zgodnie z przewodnikiem Migracja z Content API for Shopping na Merchant API , aby znaleźć nowoczesne odpowiedniki obecnych usług Content API.
  3. Zainstaluj najnowsze biblioteki klienta Merchant API w wybranym języku programowania.
  4. Zaktualizuj i przetestuj integrację w środowisku programistycznym przed wdrożeniem w środowisku produkcyjnym.

Poproś o przedłużenie terminu

Jeśli Twoja organizacja potrzebuje więcej czasu na zakończenie migracji, możesz poprosić o przedłużenie terminu, aby tymczasowo wyłączyć błędy ograniczania działania usługi w projekcie Google Cloud. Aby poprosić o przedłużenie terminu, prześlij formularz prośby o przedłużenie terminu korzystania z Content API.

Zatwierdzone przedłużenia chronią Twoje projekty przed zaplanowanymi odpowiedziami w sytuacjach błędu w okresie zatwierdzonego przedłużenia. Przedłużenia nie obejmują okresu po ostatecznym wycofaniu usługi na początku 2027 r.