A API Google Content for Shopping atingiu oficialmente a data de desativação em 18 de agosto de 2026. Todos os desenvolvedores precisam migrar as integrações atuais para a API Merchant assim que possível.
Para incentivar a migração antes da desativação completa e garantir que os desenvolvedores observem os avisos de descontinuação nos registros de aplicativos, o Google está introduzindo um processo de degradação progressiva do serviço a partir de 1º de setembro de 2026.
Cronograma de desativação
A tabela a seguir descreve o cronograma de degradação do serviço e a desativação final da API Google Content for Shopping (v2.1):
| Data | Milestone | Detalhes |
|---|---|---|
| 1º de setembro de 2026 | Introdução de solicitações com falha intermitente | As solicitações sem uma extensão ativa começam a falhar intermitentemente com HTTP 410 Gone. |
| Início de 2027 | Desativação | Desligamento completo. Todos os endpoints são desativados e todas as solicitações falham. |
Degradação do serviço e respostas de erro
A partir de 1º de setembro de 2026, as solicitações enviadas aos endpoints da API Google Content for Shopping por clientes sem uma extensão ativa vão falhar intermitentemente com um código de status HTTP 410 Gone.
Formato da resposta de erro
Quando uma solicitação é rejeitada como parte da degradação programada do serviço, a API retorna um payload de erro HTTP 410 Gone contendo a mensagem e os metadados com os detalhes do projeto na nuvem do 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"
}
}
]
}
}
A resposta de erro inclui os seguintes campos de metadados:
GCP_ID: o ID do projeto na nuvem do Google Cloud que está fazendo a solicitação.GCP_NUMBER: o identificador numérico exclusivo do projeto do Google Cloud.HELP_CENTER_LINK: um link direto para a documentação de migração.
Impacto na cota
As respostas de erro artificiais geradas durante a degradação do serviço não são contabilizadas na cota da API do seu projeto.
Como tentar novamente solicitações com falha
Como a degradação inicial do serviço faz com que apenas uma parte das solicitações falhe, tentar novamente uma solicitação com falha pode funcionar. No entanto, confiar em novas tentativas não é uma solução viável a longo prazo, porque as solicitações com falha vão se tornar mais frequentes até que todas as solicitações falhem na desativação.
Desenvolvedores afetados
O processo de desativação e degradação do serviço se aplica a desenvolvedores e empresas da seguinte maneira:
- Integrações de API personalizadas:se sua organização mantém ferramentas internas, scripts ou softwares personalizados que fazem chamadas diretas para a API Google Content for Shopping, atualize seus aplicativos para chamar a API Merchant.
- Plataformas de terceiros:se você acessar o Merchant Center por uma plataforma de e-commerce, o parceiro da plataforma vai gerenciar a migração em seu nome. Você não precisa realizar nenhuma ação.
Ação necessária
Para evitar interrupções nas suas fichas de produtos e no gerenciamento da conta:
- Consulte a visão geral da API Merchant para entender a arquitetura, a autenticação e as estruturas de sub-API.
- Siga o guia Migrar da API Content for Shopping para a API Merchant para identificar equivalentes modernos para seus serviços atuais da API Content.
- Instale as bibliotecas de cliente mais recentes da API Merchant para sua linguagem de programação.
- Atualize e teste sua integração em um ambiente de desenvolvimento antes de implantar na produção.
Solicite uma extensão
Se sua organização precisar de mais tempo para concluir a migração, você poderá solicitar uma extensão para isentar temporariamente seu projeto na nuvem do Google Cloud de erros de degradação do serviço. Para solicitar uma extensão, envie o formulário de solicitação de extensão da API Content.
As extensões aprovadas protegem seus projetos de respostas de erro programadas durante a janela de extensão aprovada. As extensões não vão além da desativação final no início de 2027.