Últimas atualizações

Fique por dentro dos novos recursos, correções de bugs e atualizações de lançamento.

Outubro de 2026

Outubro de 2026

O que há de novo:

  • Políticas de relatórios e para desenvolvedores do programa de afiliados do YouTube Shopping (v1alpha):

  • URI da página inicial da loja na sub-API Accounts: adicionamos o campo homePageUri somente leitura ao recurso accounts para retornar o URI da página inicial da loja.

  • Adições de atributos da sub-API Products:

    • Links de certificação de produtos e tipos enumerados de eficiência energética do Reino Unido: adicionamos os campos certificationDocumentLink e certificationLabelLink, além da autoridade de certificação do Departamento de Segurança Energética e Net Zero (DESNZ, na sigla em inglês) e dos tipos enumerados de nome de certificação GB_ENERGY_INFORMATION, a ProductCertification em ProductAttributes. Para mais informações, consulte Certificação.
    • Franquia de quilometragem para parcelas de veículos: adicionamos mileageAllowance a ProductInstallment em ProductAttributes para especificar franquias de quilometragem para contratos de leasing de veículos.
    • Links de vídeo no nível da oferta: adicionamos o atributo videoLinks a ProductAttributes para enviar vídeos no nível da oferta em grande escala.

  • Nova documentação do provedor de serviços terceirizado:

  • Novos exemplos de código Java para gerenciar o lote de regiões:

  • Relatórios de performance agêntica do UCP (v1alpha): adicionamos duas novas vistas de relatórios a accounts.reports.search na sub-API Reports (v1alpha) para recuperar métricas de performance de finalização de compra e performance de conversões do UCP em todas as plataformas do Google, incluindo o Modo IA na Pesquisa e no Gemini:

O que mudou:

  • Suporte expandido ao atributo de garantia: generalizamos o atributo warranty em ProductAttributes além das informações do veículo para oferecer suporte a todos os produtos e permitir que as durações da garantia sejam especificadas em meses ou anos.
  • Desnormalização de problemas da conta no nível da oferta: mostramos problemas específicos de suspensão da conta diretamente nas ofertas afetadas, em vez de um ACCOUNT_DISAPPROVAL genérico, fornecendo diagnósticos mais claros de impacto no nível da oferta, do método de marketing e do país.
  • Descontinuação de YoutubeProductPerformanceView (v1alpha): descontinuação de YoutubeProductPerformanceView na sub-API Reports (v1alpha) em favor de YoutubeProductSoldStatsView e YoutubeProductTaggedStatsView.
  • Padrões de paginação da sub-API Notifications e novos guias: padronizamos a paginação de accounts.notificationsubscriptions.list com um pageSize opcional que tem como padrão 100 (máximo de 200) e publicamos um novo guia para configurar notificações push para mudanças no serviço de conta.
  • Reorganização da documentação de referência e do guia de cotas e limites: removemos todas as páginas de referência REST e RPC v1beta descontinuadas do site para desenvolvedores e reorganizamos as cotas e limites em guias dedicados para cotas de API e limites da conta.

Agosto de 2026

Agosto de 2026

O que há de novo:

  • A API Content for Shopping foi desativada em 18 de agosto de 2026. Todos os desenvolvedores precisam migrar as integrações atuais para a API Merchant o mais rápido possível. Para mais informações, consulte Descontinuação e encerramento.
  • Integração de conta do Protocolo de Comércio Universal (UCP): adicionamos UcpCheckoutManagement como um tipo de serviço no recurso Account Service, além de suporte ao programa ucp-integration e aos Termos de Serviço do ucp_integration com acesso limitado.
  • Substituições da política de devolução no nível da oferta: adicionamos o atributo returns em ProductAttributes para configurar e substituir políticas de devolução (por exemplo, país, dias do período, taxas de devolução, condição) diretamente no nível do item.
  • Atributos de aluguel de imóveis: adicionamos atributos de informações do produto principais, incluindo leaseTerm a ProductAttributes, para enviar dados de anúncios de aluguel.
  • Melhorias na sub-API Inventories:
  • Notificações de serviço da conta: adicionamos ACCOUNT_SERVICE como um NotificationEventType compatível na sub-API de notificações para acompanhar as mudanças de status nos serviços da conta. Para mais informações sobre notificações de mudanças no serviço de conta, consulte Receber notificações push sobre mudanças no serviço de conta.
  • Visualizações de relatórios de afiliados do YouTube Shopping (v1alpha):
  • Endpoint da Segmentação por lista de clientes com fidelidade: faça upload e gerencie dados de fidelidade do cliente para mostrar os benefícios do nível (por exemplo, preços para membros) nos resultados da pesquisa orgânica. Para mais informações sobre os dados de fidelidade do cliente, consulte Visão geral do serviço de Segmentação por Lista de Clientes com Fidelidade.
  • Repositório público de bibliotecas de cliente Alfa: as bibliotecas Alfa para a sub-API Reviews em Python, Java, PHP, C#, Ruby, Node.js e Go já estão disponíveis no repositório público do GitHub.

O que mudou:

  • Filtro de nível de acesso ListAccounts: introduzimos o parâmetro access, que oferece suporte a DIRECT, INDIRECT e ALL para filtrar contas com base nas permissões do autor da chamada. Isso pode ser usado para distinguir entre contas avançadas e subcontas.
  • Validações de cotas e regras do DataSources:
    • Introduzimos o gerenciamento automático de cotas para fontes de dados em contas avançadas. Para mais detalhes, consulte Noções básicas sobre cotas e limites.
    • Adicionamos uma validação de regra que exige que as regras padrão nas fontes de dados de produtos principais contenham exatamente uma referência a self ou a uma fonte de dados principal.
    • O uso de primaryDataSourceName em DataSourceReference foi descontinuado em favor de self.
  • Melhorias na latência: redução da sobrecarga da API para chamadas de inserção, atualização e exclusão de produtos.

O que vem por aí:

  • Descontinuação e encerramento da API Content for Shopping: lembrete para fazer a transição para a nova API Merchant. 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 vai introduzir um processo de degradação progressiva do serviço a partir de 1º de setembro de 2026. Para mais informações, consulte a seção Cronograma de desativação da API Content for Shopping.

Maio de 2026

Maio de 2026

O que há de novo:

O que mudou:

  • A versão v1beta da API Merchant foi desativada. Todas as chamadas de API agora precisam ser direcionadas para as versões v1 ou v1alpha. Para ver as etapas de migração, consulte Migrar da v1beta para a v1.
  • Atualizações mais frequentes no nível do atributo para price e availability agora estão disponíveis pelo método patch na sub-API Products. Esse recurso permite que você atualize esses atributos específicos com menor latência, o que aumenta a atualização de dados. No momento, isso só está disponível para comerciantes na lista de permissões. Para saber mais ou solicitar acesso, entre em contato com seu representante do Google.

O que vem por aí:

  • Análise de performance de agentes com a UCP na API Reports.

Janeiro de 2026

Janeiro de 2026

O que há de novo:

O que mudou:

  • Adicionamos InventoryLoyaltyProgram ao serviço de inventário local para que os usuários tenham controle consolidado sobre os recursos de fidelidade, como descontos, cashback para compras futuras e pontos de fidelidade.

O que vem por aí:

  • Desativação da API Merchant v1beta em 28 de fevereiro de 2026. Direcione todas as chamadas de API para as versões v1 e v1alpha, respectivamente, antes do prazo de desativação da v1beta.
  • Ativar e desativar o programa de avaliações do produto usando a API Reviews v1alpha, que simplifica o processo de envio e gerenciamento de avaliações do produto.

Novembro de 2025

Novembro de 2025

O que há de novo:

  • Novos insights para análises de afiliados do YouTube Shopping (v1alpha), na sub-API Reports para recuperar análises sobre criadores de conteúdo, conteúdo e produtos em destaque no YouTube. Ele oferece paridade com os relatórios disponíveis no Google Merchant Center (GMC).
  • Uma ferramenta de diagnóstico de API atualizada para ajudar na migração para a API Merchant(v1).
  • Adicionamos um novo campo product_filters à sub-API Accounts para permitir que os comerciantes compartilhem apenas um subconjunto do feed com as contas do Google Ads, com base em alguns filtros condicionais nos atributos dos produtos do comerciante. Esse recurso está disponível apenas para um número limitado de comerciantes.
  • Adicionamos suporte para a criação de contas independentes para vendedores em plataformas de e-commerce.
  • Adicionamos dois novos métodos, accounts.limits.get e accounts.limits.list, para consultar os limites da conta na API Quota.

O que mudou:

  • A detecção automática e a decodificação interna de IDs de produtos codificados em base64url já estão disponíveis em todos os métodos que usam IDs de produtos.

O que vem por aí:

  • Novos insights para análises de afiliados do YouTube Shopping (v1alpha), na sub-API Reports para recuperar análises sobre criadores de conteúdo, conteúdo e produtos em destaque no YouTube. Ele oferece paridade com os relatórios disponíveis no Google Merchant Center (GMC).

  • Desativação da versão v1beta da API Merchant em 28 de fevereiro de 2026. Todas as chamadas de API precisam ser direcionadas para as versões v1 e v1alpha, respectivamente, antes do prazo de desativação da v1beta. Para mais informações, consulte a política de desativação e controle de versões da API Merchant.

Setembro de 2025

Setembro de 2025

O que há de novo:

  • O primeiro serviço do Protocolo de Contexto de Modelo (MCP) para a API Merchant já está disponível.
    • O novo serviço MCP integra a documentação oficial da API Google ao assistente de programação do seu ambiente de desenvolvimento integrado (IDE, na sigla em inglês) para acelerar a integração da API Merchant e melhorar a precisão dos fluxos de trabalho de migração.
  • Um novo método, getAccountForGcpRegistration, na sub-API Accounts para recuperar a conta do comerciante registrada no Google Cloud.

O que mudou:

  • Novos métodos para gerenciamento de regiões na sub-API Accounts.
    • A introdução de três novos métodos, batchCreate, batchDelete e batchUpdate, para permitir o lote de chamadas para as operações create, update e delete para regiões na sub-API Accounts para facilitar o gerenciamento de regiões e mitigar as limitações das chamadas one-region-per-request.
  • Uma nova configuração de frete com base na transportadora está disponível na sub-API Products para especificar atributos de frete no nível do produto.

O que vem por aí:

  • Novos relatórios para análises do Programa de Afiliados do YouTube Shopping, como v1alpha na sub-API Reports para recuperar análises sobre criadores de conteúdo, conteúdo e produtos em destaque no YouTube que oferecem paridade com os relatórios disponíveis no Google Merchant Center.
  • Ativar atualizações mais frequentes de produtos para os atributos de disponibilidade e preço.
  • Análise mais fácil de erros de API com ErrorInfo e metadados enriquecidos.

Julho de 2025

Julho de 2025

O que há de novo:

  • A API Merchant (v1), sucessora oficial da API Content for Shopping, já está em disponibilidade geral.

    Isso significa que, daqui em diante, haverá apenas sub-APIs v1alpha e v1 na API Merchant, com a maioria das versões v1beta sendo promovidas para v1. Fique de olho para mais informações.

  • Novos recursos estão disponíveis.

    • O recurso de imagem na API Product Studio (Alfa) usa a IA generativa para criar novos planos de fundo de produtos, remover o plano de fundo de imagens e aumentar a resolução de imagens.
    • A Finalização de compra no comerciante na sub-API Accounts permite criar, atualizar, excluir e receber suas configurações de finalização de compra.
    • A política de devolução on-line na sub-API Accounts foi migrada, e a funcionalidade do usuário permanece inalterada. Pequenas melhorias técnicas, como campos desatualizados e renomeação de campos, foram removidas para manter a consistência.
    • AccountIdAlias no recurso AccountRelationship na sub-API Accounts usa um alias definido pelo usuário em vez do ID interno (ID da conta). Isso facilita o gerenciamento de estruturas de conta complexas, como o uso de um alias definido pelo usuário para seu marketplace em vez do ID interno.

  • O acesso à API Merchant agora está disponível para usuários do Apps Script.

  • Um novo método AggregateProductStatuses está disponível na API Issue Resolution para consultar estatísticas unificadas sobre o status dos produtos.

O que mudou:

  • Capacidade de criar contas independentes para criadores de lojas e CSSs. Antes, as contas do comerciante eram criadas em uma única conta avançada.

  • Classificações de potencial de cliques na tabela productView na sub-API de relatórios. Agora, a classificação de produtos com base em clickPotential é normalizada para valores entre 1 e 1.000. Os produtos com clickPotentialRank baixo ainda têm o click potential mais alto entre os produtos do comerciante que atendem às condições da consulta de pesquisa.

O que vem por aí:

  • Acesso pelo servidor do Protocolo de Contexto de Modelo (MCP, na sigla em inglês) (v1alpha).

Maio de 2025

Maio de 2025

O que há de novo:

  • Lançamos duas novas sub-APIs.
    • O rastreamento de pedidos oferece suporte ao histórico de rastreamento de pedidos comerciais para fornecer estimativas de envio precisas aos clientes. Os indicadores também permitem listagens de produto avançadas com frete grátis e rápido.
    • A resolução de problemas oferece acesso ao conteúdo de diagnóstico e às ações de suporte da mesma forma que está disponível na interface do Merchant Center.
  • Novos recursos estão disponíveis na sub-API Accounts.
    • gerencia a configuração da conta para veiculação omnichannel, como listagens locais sem custo financeiro (FLL) e anúncios de inventário local (LIA).
    • LfpProviders se conecta aos parceiros do programa de parceria de feeds locais (LFP, na sigla em inglês) para receber dados de inventário.
    • GbpAccounts se conecta à conta do Perfil da Empresa no Google para acessar os dados da loja local.
    • OnlineReturnPolicy oferece a capacidade de criar, excluir e atualizar suas políticas on-line.
  • Um novo método está disponível na sub-API Products.
    • Com ProductsUpdate, é possível atualizar produtos individuais sem precisar fornecer todos os campos obrigatórios para ProductInput.

O que mudou:

  • O limite máximo de pageSize aumentou de 250 para 1.000 linhas por chamada de API.
  • Um atraso que existia para inserção de produtos, promoções, avaliações do produto e avaliações de comerciantes após a criação de DataSources foi corrigido.

O que vem por aí:

  • Descontinuação e remoção futura do campo de canal para DataSources e produtos.
  • Lançamento de uma definição atualizada para clickPotentialRank na tabela productView na sub-API Reports:
    • A classificação de produtos com base em clickPotential é normalizada para valores entre 1 e 1.000.
    • Os produtos com clickPotentialRank baixo ainda têm o maior potencial de cliques entre os produtos do comerciante que atendem às condições da consulta de pesquisa. Essa é uma mudança não interruptiva que pode ser lançada em 1º de julho de 2025.
  • O AccountIdAlias no recurso AccountRelationship permite gerenciar melhor estruturas de conta complexas. Por exemplo, os marketplaces usam um alias definido pelo usuário em vez do ID interno do comerciante, como o ID da conta.

Abril de 2025

Abril de 2025

O que há de novo:

O que mudou:

  • Agora oferecemos suporte a destinos, conhecidos como métodos de marketing no Merchant Center para a sub-API Data Sources.
  • Fizemos vários ajustes no recurso e recomendamos que você consulte as notas da versão de contas para mais detalhes.
  • Os campos taxes e tax_category na sub-API Products foram descontinuados, assim como o campo accounttax na API Content.

O que vem por aí:

  • Consideramos seu feedback e estamos trabalhando em várias áreas para melhorar a documentação para desenvolvedores da API.
  • Fique de olho e volte com mais frequência. Além disso, sinta-se à vontade para enviar mais feedback.
Anterior
YouTube Shopping developer policies
Avançar
Design