Notas da versão (v2.1)

30 de outubro de 2024

Como parte do desligamento das APIs relacionadas a liquidação, os seguintes serviços foram descontinuados: - settlementreports - settlementtranscations

A desativação das APIs relacionadas ao acordo está relacionada à desativação anterior do programa BuyOnGoogle e de APIs relacionadas a Orders.

As chamadas para os serviços mencionados acima devem falhar com uma resposta Service was not found on the server.

16 de outubro de 2024

update_mask em UpdateConversionSourceRequest agora é OPTIONAL. Se nenhuma máscara de atualização for especificada, todos os campos que tiverem um valor não vazio serão atualizados.

26 de agosto de 2024 (antes do previsto)

Como parte da desativação das APIs relacionadas a Orders, os seguintes serviços foram descontinuados: - orderinvoices - orderreports - orderreturns - orderreturns.labels - orders

As chamadas para os serviços mencionados acima devem falhar com uma resposta Service was not found on the server.

O serviço OrderTrackingSignals não foi descontinuado e continua disponível.

10 de agosto de 2024

Serviços do Comprar com o Google

Como parte do desligamento das APIs Compras no Google, todos os métodos em BuyOnGoogleProgramService vão falhar com service was not found on the server.

19 de julho de 2024

Serviço de produtos

Adicionamos o campo member_price_effective_date. Essa atualização permite especificar, se aplicável, o período em que o preço para membros de fidelidade vai entrar em vigor. Se o valor do campo não for fornecido, o preço do membro sempre será válido.

20 de maio de 2024

Serviço de produtos

LoyaltyPrograms foi adicionado. Com essa atualização, você pode oferecer vários níveis com diferentes pontos de fidelidade, preços etc. para um único produto. Use esse campo no lugar do campo LoyaltyProgram singular.

Serviço de relatórios

Métricas do Comprar com o Google descontinuadas na tabela MerchantPerformanceView. Após essa atualização, a recuperação de qualquer métrica do Comprar com o Google vai retornar 0. Isso também se aplica a valores históricos de datas anteriores.

Para mais informações, consulte Descontinuação do Comprar com o Google.

13 de maio de 2024

Serviço de produtos

Recurso de produto

Mudanças no campo de certificações: adicionamos certificationValue ao campo ProductCertification para fornecer o valor da certificação (também conhecido como classe, nível ou grau), que permite aos usuários fazer upload de informações de certificação, mesmo que a autoridade certificadora não emita o código ou número da certificação.

Para mais informações, consulte nossos guias de produtos.

6 de maio de 2024

Serviço de relatórios

Adição de um intervalo de eficácia à tabela PriceInsightsProductView. A eficácia indica quais produtos se beneficiariam mais de mudanças de preço. Essa classificação considera o aumento da performance previsto pelo ajuste do preço promocional e a diferença entre o preço atual e o sugerido.

24 de abril de 2024

Serviço de produtos

Recurso de produto

Os campos downpayment e creditType opcionais foram adicionados para pagamentos parcelados:

  • downpayment informa o valor que o comprador precisa pagar antecipadamente como um pagamento único.
  • creditType informa o tipo de pagamento parcelado (finance ou lease). Este campo só é aplicável a anúncios de veículos.

11 de abril de 2024

Serviço de produtos

Recurso de produto

  • Foi adicionado o atributo valor mínimo de frete grátis (FreeShippingThreshold) para o frete no nível da oferta. Esse atributo permite que os comerciantes insiram um preço mínimo do produto para que o custo do frete seja sem custo financeiro.
  • A visibilidade de LoyaltyPoints foi alterada

10 de abril de 2024

Serviço de produtos

Recurso de produto

LoyaltyProgram adicionado

9 de abril de 2024

Serviço de produtos

Recurso de produto

Foram adicionados structuredTitle e structuredDescription para fornecer títulos e descrições de produtos gerados por IA.

3 de abril de 2024

Serviço de suporte ao comerciante

Foi adicionado o campo user_input_action_option, que permite que os parceiros solicitem um novo tipo de ação: BuiltInUserInputAction. Com essa ação, os parceiros podem criar funções complexas de autoatendimento para comerciantes diretamente no aplicativo, em vez de redirecioná-los para o Merchant Center.

Foi adicionado um novo método TriggerAction para BuiltInUserInputAction. Para acessar esse método, envie uma solicitação para este formulário.

27 de março de 2024

Serviço de produtos

Recurso de produto

AutoPricingMinPrice foi adicionado como uma proteção nos projetos "Descontos automáticos" e "Promoções dinâmicas", garantindo que os descontos nas ofertas dos comerciantes não reduzam o preço do produto para um valor menor do que esse. Assim, o valor e a lucratividade da oferta são preservados.

15 de março de 2024

O programa Comprar com o Google para a Pesquisa e o Shopping será encerrado. Você pode continuar visualizando os pedidos até 31 de outubro de 2024 usando orders.list e orders.get.

8 de março de 2024

Serviço de relatórios

O relatório TopicTrendsView foi adicionado ao serviço Reports.

Para mais informações, consulte nossos guias de relatórios.

6 de março de 2024

Serviço de relatórios

Foi adicionado um bucket e uma classificação de potencial de cliques para produtos.

Para mais informações, consulte nossos guias de relatórios.

19 de fevereiro de 2024

Serviço ConversionSources

Os seguintes valores foram removidos como origens de conversão válidas:

  • CROSS_CHANNEL_FIRST_CLICK
  • CROSS_CHANNEL_LINEAR
  • CROSS_CHANNEL_POSITION_BASED
  • CROSS_CHANNEL_TIME_DECAY

As opções de 60 e 90 dias como janela de lookback foram removidas, e 40 dias foi adicionada como uma opção válida.

17 de janeiro de 2024

Serviço de PDV

Foram adicionados novos valores para o campo matching_status_hint em PosStore, que permite que os usuários tenham mais detalhes sobre por que a correspondência de lojas falhou.

11 de janeiro de 2024

Serviço de contas

localProductManager e localProductManagement foram adicionados como tipo de link e serviço, respectivamente, para o método link. Assim, é possível vincular contas para gerenciar dados de produtos disponíveis na loja física.

29 de novembro de 2023

Serviço de suporte ao comerciante

Foi adicionado o tipo de ação externa VERIFY_IDENTITY_IN_MERCHANT_CENTER para verificação de identidade que precisa ser realizada no Merchant Center.

Serviço de PDV

Adicionamos os campos matching_status e matching_status_hint a PosStore, que permitem aos usuários saber o status correspondente da Pos Store com a loja do Perfil da Empresa no Google e uma dica a ser corrigida em caso de problema.

15 de novembro de 2023

Os endpoints repricingrules e repricingrules.repricingreports não têm mais suporte.

1º de novembro de 2023

Serviço de configurações de frete

O shipment_type=pickup não é mais compatível.

18 de outubro de 2023

Serviço de contas

Adicionamos o campo Business Identity, que permite que os comerciantes se autoidentifiquem em determinados valores do consumidor.

10 de Outubro de 2023

Collection Point foi adicionado como um novo tipo de envio do serviço de configurações de frete. A entrega no local de coleta é um serviço fornecido por terceiros (por exemplo, que não é do comerciante) para entregar o item em um local afiliado a terceiros (como pontos de acesso UPS), em vez de entregar diretamente na casa.

18 de setembro de 2023

Serviço de configurações de LIA

Foi adicionado o método setOmnichannelExperience para permitir que os usuários definam a experiência omnichannel (ou seja, as configurações da loja local e de retirada). No momento, essa opção está disponível apenas para usuários cujo provedor de PDV é confiável para ativar essas configurações.

7 de setembro de 2023

Descontinuação do Comprar com o Google

Adição de um novo status DEPRECATED ao método GetBuyOnGoogleProgramStastus. Não é possível reativar ou pausar o programa nesse estado.

4 de setembro de 2023

Serviço de suporte ao comerciante

Ação integrada FIX_ACCOUNT_ISSUE foi adicionada para problemas de produto que precisam ser resolvidos no nível da conta. Ação integrada SHOW_ADDITIONAL_CONTENT foi adicionada para fornecer uma justificativa de uma autoridade nacional.

28 de agosto de 2023

Serviço de promoções

O método list aberto no serviço Promotions passou de acesso limitado para todos.

22 de agosto de 2023

Serviço de suporte ao comerciante

Lançamento do serviço de suporte ao comerciante. Esse serviço oferece conteúdo de suporte para problemas de conta e de produto.

4 de agosto de 2023

Serviço de relatórios

Adicionamos o relatório de visibilidade competitiva de concorrentes próximos ao serviço de relatórios.

Para mais informações, consulte nossos guias de relatórios.

25 de julho de 2023

Serviço de PDV

Recurso de inventário

Adicione os campos pickup_method e pickup_sla para permitir que os comerciantes enviem informações de retirada com o inventário.

14 de julho de 2023

Serviço de relatórios

Adicionamos relatórios de visibilidade competitiva ao serviço de relatórios.

Para mais informações, consulte nossos guias de relatórios.

7 de julho de 2023

Serviço de produtos

Recurso do produto

virtualModelLink foi adicionado para fornecer URLs à imagem do modelo 3D.

4 de julho de 2023

Serviço de produtos

Recurso de produto

Adicione o campo certifications para fornecer certificações de produto. Por exemplo, para rotulagem de eficiência energética de produtos com base no banco de dados EPREL da UE.

26 de junho de 2023

Serviço de configurações de frete

Fulfillment local

Foi adicionado o campo no_delivery_post_cutoff para permitir que os comerciantes desativem a exibição da entrega local em n+1 dia quando tiverem um serviço de frete configurado para a entrega local em n dias.

29 de maio de 2023

Serviço de promoções

O método list foi adicionado ao serviço Promotions.

Serviço de recomendação

Ative a dispensa de interação no método ReportInteraction do serviço de recomendações.

9 de maio de 2023

Destino do Cloud para varejo

Propriedades adicionais do Cloud para varejo

Adicione o campo de propriedades adicionais de varejo em nuvem. Esse é um campo repetido que deve ser usado pelos clientes que usam o destino do Cloud Retail. Quando esse campo é usado, ele fica disponível ao usar o programa de varejo na nuvem. Isso será mapeado para o campo de atributos no modelo de produto de varejo do Google Cloud.

22 de maio de 2023

Serviço de promoções

O método list foi adicionado ao serviço Promotions.

11 de abril de 2023

Serviço de configurações de frete

Fulfillment local

Adicionamos a opção de atendimento de entrega local para comerciantes que criam uma nova configuração de frete. Eles podem definir as configurações para lojas locais no novo campo storeConfig. Isso inclui o raio de serviço, o horário limite e os códigos de lojas que oferecem entrega local.

3 de abril

Serviço de recomendações

Serviço de recomendações lançado. Esse serviço oferece maneiras sugeridas de melhorar a performance da sua conta de comerciante e permite que você informe cliques do comerciante em recomendações úteis.

20 de fevereiro de 2023

Serviço de contas

Recurso da conta

Adicionamos uma nova seção Account.ConversionSettings no recurso Accounts.

Serviço ConversionSources

Adicionamos o serviço de origens de conversão, que oferece suporte ao gerenciamento de origens de conversão (parte da seção "Configurações de conversão" no Merchant Center).

16 de fevereiro de 2023

Serviço de configurações de frete

Validação do código da loja

Os códigos de loja agora são validados para garantir que eles pertencem ao comerciante antes que as configurações de frete sejam atualizadas.

Validação de comerciante de LIA

Os programas em que um ID de comerciante está inscrito agora são validados antes que as configurações de frete sejam atualizadas. Os comerciantes precisam estar em um dos seguintes programas:

  • LOCAL_INVENTORY_ON_SURFACES_ACROSS_GOOGLE
  • LOCAL_INVENTORY_ADS

9 de fevereiro de 2023

Serviço de promoções

Amplie o serviço de promoções para mais seis targetCountry opções com suporte contentLanguage local.

  • BR
  • ES
  • NL
  • JP
  • IT
  • KR

12 de janeiro de 2023

Serviço de produtos

Recurso do produto

lifestyleImageLinks foi adicionado para fornecer URLs de imagens de estilo de vida.

24 de novembro de 2022

Serviço de promoção

Um novo campo "promotionStatus" foi adicionado à seção Promotions.PromotionStatus. Esse é um campo somente leitura.

15 de novembro de 2022

Serviço de relatórios

Adicionamos os relatórios de insights do mercado ao serviço de relatórios.

Agora você pode consultar o serviço de relatórios para:

Para mais informações, consulte nossos guias de relatórios.

7 de novembro de 2022

Serviço de feeds de dados

Foi adicionado suporte a feedLabel para o serviço Datafeeds.

14 de setembro de 2022

Atualizamos feedLabel para aceitar qualquer string.

9 de agosto de 2022

Adicionado feedLabel para produtos.

Agora é possível usar feedLabel em vez de targetCountry para especificar o país dos IDs de oferta. Os IDs de oferta agora são criados como online:language:feedLabel:offerId.

O feedLabel foi preenchido automaticamente com seu valor targetCountry para feeds existentes para compatibilidade com versões anteriores.

O uso de targetCountry foi descontinuado.

Para oferecer suporte a ofertas globais, a API Content for Shopping descontinuou o campo targetCountry. Em vez disso, recomendamos usar o campo shipping para especificar os países de destino.

O targetCountry agora é preenchido automaticamente com o valor fornecido em feedLabel.

Consulte a postagem do blog O rótulo do feed substitui o país de destino na API Content do Shopping para mais detalhes.

8 de dezembro de 2021

Serviço de contas

Recurso da conta

Adicionamos uma nova seção Account.AutomaticImprovements no recurso Accounts.

Com essa nova seção, os comerciantes podem atualizar itens automaticamente, melhorar imagens e configurações de frete.

25 de outubro de 2021

Serviço de promoção

Adição de "Get Promotion" à API Promotion.

11 de outubro de 2021

API Shipping Settings

Foi adicionado um novo campo warehouse no recurso ShippingSettings para permitir que os comerciantes gerenciem os armazéns que podem ser usados em WarehouseBasedDeliveryTime.

Adição do novo campo warehouseName em WarehouseBasedDeliveryTime para se referir ao warehouse pelo nome do armazém.

4 de outubro de 2021

Serviço de contas

Recurso da conta

Adicionamos um novo campo "phone_verification_status" na seção Accounts.BusinessInformation. Este é um campo somente leitura, definido por Accounts.VerifyPhoneNumber.

13 de setembro de 2021

Serviço BuyOnGooglePrograms

Recurso BuyOnGoogleProgramStatus

Foram adicionados novos campos no recurso BuyOnGooglePrograms.BuyOnProgramStatus, que representam: canais de vendas on-line, modelos de negócios e telefone de atendimento ao cliente.

Novo método UpdateBuyOnGoogleProgramStatus

Adicionamos um novo método, UpdateBuyOnGoogleProgramStatus, que permite atualizar o recurso BuyOnGooglePrograms.BuyOnProgramStatus estendido.

6 de setembro de 2021

Serviço de contas

Recurso da conta

Adicionamos um novo campo "korean_business_register_number" à seção Accounts.BusinessInformation. Esse campo só será limpo se for definido explicitamente como uma string vazia.

30 de agosto de 2021

Serviço de promoção

Foi adicionado um novo serviço de promoção com a promoção de encartes disponível.

Serviço de pedidos

Um novo método orders/captureOrder foi adicionado para capturar fundos antes do envio.

Novo motivo de cancelamento do pedido FAILED_TO_CAPTURE_FUNDS

Serviço de produtos

Recurso de produto

productLength, productHeight, productWidth e productWeight foram adicionados para fornecer dimensões e peso do produto.

9 de agosto de 2021

Serviço RepricingRule

RepricingRule Type

Novo valor de enumeração para o campo RepricingRuleType.

TYPE_SALES_VOLUME_BASED e TYPE_COMPETITIVE_PRICE foram adicionados.

17 de maio de 2021

Serviço de rótulos para devoluções de pedidos

Um novo campo "product_id" foi adicionado à CreateReturnRequest. Os comerciantes podem especificar o product_id ou o line_item_id para identificar o item a ser devolvido.

Serviço de produtos

Um novo método foi adicionado para atualizar produtos existentes. Para atualizar um produto, forneça apenas os campos que precisam ser atualizados, e não o produto inteiro.

3 de maio de 2021

Serviço de rótulos para devoluções de pedidos

Foram adicionados novos métodos para fazer upload de rótulos para devoluções gerenciadas pelo comerciante (MMR). Com o novo orderreturns.labels.create, você pode fazer upload dos rótulos de devolução para compartilhar com o cliente.

26 de abril de 2021

API Shipping Settings

Novo campo warehouseBasedDeliveryTimes em DeliveryTime para oferecer suporte a serviços de frete que calculam a data de entrega estimada com base no local do depósito e no serviço de transportadora escolhido.

Novo campo eddServices no objeto CarriersCarrier para retornar os nomes dos serviços aplicáveis para calcular a data de entrega estimada.

12 de abril de 2021

Serviço de produtos

Recurso do produto

Novo campo additionalSizeType para oferecer suporte a até dois tipos de tamanho por produto.

Mudanças no campo de frete: foram adicionados minHandlingTime, maxHandlingTime, minTransitTime e maxTransitTime a ProductShipping para oferecer a velocidade de frete do nível da oferta.

28 de janeiro de 2021

Serviço de contas

Adição de suporte a rótulos automáticos aos recursos AccountLabel e Account. Para mais informações, consulte a seção Tipos de rótulos do CSS no guia "Gerenciamento de rótulos do CSS".

5 de outubro de 2020

Serviço CSSES

Recurso CSS

Um novo serviço csses foi adicionado para extrair informações sobre domínios CSS e atribuir rótulos a eles. O recurso AccountLabel agora também pode ser usado para criar e listar rótulos no nível do grupo do CSS. Para mais informações, consulte Gerenciamento de rótulos CSS.

24 de agosto de 2020

Serviço de produtos

Recurso de produtos

Novo campo shoppingAdsExcludedCountries para excluir ofertas de publicidade em determinados países.

Recurso Productstatuses

Novos campos approvedCountries, pendingCountries e disapprovedCountries no objeto destinationStatuses que fornecem informações sobre o status da oferta além de targetCountry.

Novo campo itemLevelIssues.applicableCountries.

10 de agosto de 2020

Serviço de contas

Adicionamos um novo recurso AccountLabel para gerenciar rótulos de conta do Merchant Center para o CSS Center. Os usuários do CSS Center agora também podem listar as contas do Merchant Center e atribuir rótulos a elas com os métodos accounts.list, accounts.get e accounts.updatelabels. Para mais informações, consulte Gerenciamento de rótulos do CSS.

19 de junho de 2020

Serviço de produtos

Recurso do produto

Novos campos

Novos campos productDetails, productHighlights, subscriptionCost e canonicalLink.

2 de junho de 2020

Serviço de pedidos

Foram adicionados novos métodos para iniciar reembolsos sem devoluções. Com o novo orders.refunditem e orders.refundorder, você pode iniciar reembolsos de pedidos mesmo que eles não sejam devolvidos pelo cliente.

27 de abril de 2020

Serviço de devolução de pedidos

Foram adicionados os novos métodos acknowledge e process, além de novos filtros e campos para métodos de leitura (list, get).

Vinculação com o GMB

Agora é possível vincular contas do Merchant Center a uma conta do Google Meu Negócio usando o ID da conta do Google Meu Negócio.

14 de abril de 2020

APIs Settlement Report

Adicionado um novo serviço para receber relatórios de quitação.

9 de março de 2020

API Local inventory

Adicionamos um novo serviço para enviar dados de inventário local.

2 de março de 2020

API de configurações de notificação do Pub/Sub

Adição de um novo serviço para gerenciar as configurações das notificações pubsub.

3 de dezembro de 2019

Serviço de produtos

Agora é possível usar feeds complementares da API Content em contas de múltiplos clientes.

11 de setembro de 2019

Serviço de pedidos

Foi adicionado suporte para remessas para retirada nos pedidos e recursos de sandbox correspondentes.

14 de agosto de 2019

Novos serviços

Adicionamos novos serviços de política de devolução e endereço de devolução para o Comprar com o Google.

Serviço de pedidos

Recurso de pedido

Novo campo

Novo campo quantityUndeliverable.

7 de agosto de 2019

Serviço de pedidos

Recurso de pedido

Novos campos

Foram adicionados novos campos loyaltyInfo e invoiceReceivingEmail ao recurso de pedidos.

1º de julho de 2019

Serviço de produtos

Suporte a feeds complementares da API Content adicionados ao serviço de produtos.

11 de junho de 2019

Serviço de pedidos

Recursos de ordenação e TestOrder

Adição de ajuste de preço

Novo campo lineItem[].adjustments adicionado, que contém o ajuste do preço e do tributo do item de linha original causado pela aplicação de promoções.

14 de fevereiro de 2019

Mudanças introduzidas nesta versão

O modo de teste não é mais compatível

O parâmetro dryRun foi removido da v2.1. Isso se aplica a todas as chamadas de API.

Os métodos de patch não são mais compatíveis

Os seguintes serviços não são mais compatíveis com o método patch:

  • Contas
  • Accounttax
  • Feeds de dados
  • Liasettings
  • Configurações de frete

Remoção de métodos HTTP BATCH

Todos os métodos HTTP BATCH foram removidos da v2.1. Use customBatch. Estes são os serviços afetados:

  • Contas
  • Accountstatuses
  • Feeds de dados
  • Status do feed de dados
  • Ligações
  • Relatórios de pedidos
  • Pos.
  • Produtos
  • Status dos produtos
  • Shippingsettings

Serviço de contas

Atualizar

Os campos businessInformation e googleMyBusinessLink na solicitação foram introduzidos após o lançamento inicial da API Content v2. Por isso, há uma proteção que impede que os comerciantes excluam acidentalmente informações nesses dois campos com update se eles não forem fornecidos.

Na v2, os comerciantes precisam fornecer explicitamente esses campos com um corpo vazio ( {}) para excluí-los. Na v2.1, os campos são excluídos se você fornecer um corpo vazio ou se não os fornecer.

Recurso da conta

Rebranding do AdWords para Google Ads

Com a mudança do AdWords para Google Ads, os seguintes campos relacionados ao AdWords foram renomeados:

  1. adwordsLinks -> adsLinks
  2. adwordsLinks.adwordsId -> adsLinks.adsId
Remoção de campos e valores descontinuados

O campo reviewsUrl descontinuado foi removido. Além disso, o status da vinculação inactive foi removido para adsLinks, googleMyBusinessLink e youtubeChannelLinks.

Serviço de Accountstatuses

Recurso AccountStatus

Remoção de dataQualityIssues

Eles foram substituídos por itemLevelIssues.

Serviço de feed de dados

Recurso do feed de dados

Remoção de campos descontinuados

Os campos contentLanguage, targetCountry e intendedDestinations foram removidos e substituídos por country, language, includedDestinations e excludedDestinations em targets.

Remoção da atualização do inventário de produtos

Os feeds do tipo product inventory update foram removidos.

Serviço de inventário

O serviço inventory da v2 foi removido e substituído por dois novos recursos na v2.1:

Serviço de pedidos

CancelLineItem

Os campos amount, amountPretax e amountTax da solicitação foram removidos. O valor reembolsado agora é calculado automaticamente.

CustomBatch

CustomBatch foi removido da v2.1.

InStoreRefundLineItem

Os campos amountPretax e amountTax foram substituídos por priceAmount e taxAmount, respectivamente. O campo priceAmount pode ser antes ou depois dos impostos, dependendo do local do pedido.

Reembolso

Esse método foi removido. Use returnRefundLineItem.

ReturnLineItem

Esse método foi removido. Use returnRefundLineItem sem fornecer um valor de reembolso.

ReturnRefundLineItem

Os campos amountPretax e amountTax foram substituídos por priceAmount e taxAmount, respectivamente. O campo priceAmount pode ser antes ou depois dos impostos, dependendo do local do pedido.

ShipLineItem

Os campos carrier, shipmentId e trackingId na solicitação foram movidos para shipmentInfos.

Recursos de ordenação e TestOrder

Novo formato de promoção

Há um novo formato de promoção na v2.1. Não é possível criar pedidos de teste com promoções.

Remoção de campos descontinuados

O campo paymentMethod foi removido, e billingAddress epredefinedBillingAddress agora são campos de nível superior em Order e TestOrder, respectivamente.

Além disso, customer.explicitMarketingPreference foi removido e substituído por customer.marketingRightsInfo no Order e no TestOrder.

O campo customer.email descontinuado foi removido.

O formato do campo promotions foi alterado no recurso Order.

Serviço de pagamentos de pedidos

Este serviço foi removido da v2.1.

Serviço de produtos

A resposta de uma insert vai conter apenas os seguintes atributos:

  • channel
  • contentLanguage
  • id
  • offerId
  • targetCountry

Os avisos e erros não fatais não são mais retornados na resposta. Isso permite uma melhor integração com as regras de feed e outros recursos avançados de gerenciamento de feed.

Agora há um atraso de alguns minutos antes que um produto inserido possa ser recuperado por get ou list.

Não há mais garantia de que o ID da oferta retornado não será mais igual ao ID da oferta de entrada.

Os preços agora são validados antes da inserção do produto. Somente os seguintes caracteres são permitidos na string de valor: +, -, . e dígitos (0-9). As vírgulas não são mais aceitas.

Recurso de produto

CustomGroups substituídos por customAttributes recursivos

Antes, os atributos personalizados podiam ser agrupados adicionando atributos personalizados no mesmo grupo personalizado na v2. Os atributos personalizados agora são recursivos na v2.1, o que elimina a necessidade de grupos personalizados.

Os atributos personalizados agora têm um campo groupValues adicional, além do campo value original. exatamente um deles precisa ser definido, o que significa que não podem ser definidos ou omitidos simultaneamente.

Como os comerciantes podem alternar entre a v2 e a v2.1, é possível que os produtos tenham atributos personalizados recursivos que não podem ser representados na v2, já que os grupos personalizados têm no máximo dois níveis. Nesse caso, o grupo de atributos personalizados será truncado.

Remoção de tipo e unidade em customAttributes

Na v2.1, os atributos personalizados não vão mais conter type e unit. Em vez disso, as unidades precisam ser anexadas ao value (se presente) e os tipos precisam ser detectados automaticamente. Por exemplo, use "1,23 EUR" ou "5,6 cm" como value na v2.1.

ProductTypes substitui productType e additionalProductTypes

Antes, os tipos de produtos eram armazenados em dois campos, com o primeiro tipo no campo singular productType e o restante no campo repetido additionalProductTypes. Na v2.1, os dois campos foram substituídos por um único campo repetido productTypes.

O atributo "destinations" foi substituído por "includedDestinations" e "excludedDestinations".

Os destinos foram inseridos como uma lista de pares de nome e intent de destino na v2 no campo repetido destinations. Este campo foi substituído pelos dois campos repetidos a seguir: includedDestinations e excludedDestinations. Os destinos ativados por padrão não precisam ser incluídos em includedDestinations.. Isso vai corresponder à configuração de substituições de destino nos feeds.

Com a mudança do AdWords para Google Ads, os seguintes campos relacionados ao AdWords foram renomeados:

  • adwordsGrouping -> adsGrouping
  • adwordsLabels -> adsLabels
  • adwordsRedirect -> adsRedirect
Remoção de campos descontinuados

Os seguintes campos descontinuados foram removidos:

  • aspects
  • destinations
  • onlineOnly
  • validatedDestinations
  • warnings

Serviço de status dos produtos

Obter e listar

O atributo product foi removido, junto com o parâmetro includeAttributes. Para recuperar os atributos do produto correspondentes a um status, use o serviço Products e o valor do novo campo productId.

Lista

O parâmetro includeInvalidInsertedItems foi removido. Todos os produtos agora são retornados, independentemente de serem válidos. Isso significa que list agora se comporta como se includeInvalidInsertedItems estivesse sempre definido como true.

Recurso ProductStatus

DestinationsStatuses

Os campos intention, approvalStatus e approvalPending em destinationStatuses foram substituídos por status, que é uma string que pode ser approved, disapproved ou pending.

Remoção de dados

Eles foram substituídos por itemLevelIssues.