Notas da versão (v2.1)

18 de agosto de 2025

A API Content está obsoleta e será desativada em agosto de 2026. Migrar para a API Merchant

19 de junho de 2025

Serviço de produtos

Recurso "Product"

Adicionamos o campo maximum_retail_price para permitir a especificação do preço máximo de varejo (MRP, na sigla em inglês) na Índia.

Serviço de suporte ao comerciante

26 de maio de 2025

Serviço de contas

Agora é possível adicionar usuários somente leitura às contas.

14 de abril de 2025

Serviço de contas

Como isso não será mais um requisito no futuro, o serviço accounttax foi descontinuado.

17 de março de 2025

Como parte do encerramento das APIs relacionadas a pedidos, os seguintes serviços foram descontinuados:

  • accounts.verifyphonenumber
  • returnpolicy

Outros serviços

Esse endpoint não é mais necessário e pode ser descontinuado:

  • pubsubnotificationsettings

10 de fevereiro de 2025

Adicionamos os campos prerendered_out_of_court_dispute_settlement a ProductIssue e AccountIssue.

Campos alternate_dispute_resolution descontinuados de RenderProductIssuesResponse e RenderAccountIssuesResponse.

12 de dezembro de 2024

Serviço de produtos

Adicionamos o campo sustainability_incentives para especificar incentivos de sustentabilidade, como crédito fiscal ou desconto no preço, para seus produtos. Se o valor do campo não for fornecido, o item não vai se qualificar para nenhum incentivo de sustentabilidade.

15 de novembro de 2024

Serviço de produtos

Para LoyaltyProgram, adicionamos o campo shipping_label para especificar a qualificação. Se o campo tiver um valor, essa oferta terá um benefício de frete de fidelidade. Se o valor do campo não for fornecido, o item não vai se qualificar para o frete do programa de fidelidade no nível especificado.

30 de outubro de 2024

Como parte da desativação das APIs relacionadas a pagamentos, os seguintes serviços foram descontinuados:

  • settlementreports
  • settlementtranscations

O encerramento das APIs relacionadas a pagamentos está relacionado ao programa BuyOnGoogle e às APIs relacionadas a pedidos, que foram desativados anteriormente.

As chamadas aos 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 com um valor não vazio serão atualizados.

26 de agosto de 2024 (antes do que foi comunicado originalmente)

Como parte do encerramento das APIs relacionadas a pedidos, os seguintes serviços foram descontinuados:

  • orderinvoices
  • orderreports
  • orderreturns
  • orderreturns.labels
  • orders

As chamadas aos 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 encerramento das APIs do Comprar com o 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. Com essa atualização, você pode especificar, se aplicável, o período em que o preço para membros do programa de fidelidade é válido. Se o valor do campo não for fornecido, o preço para membros será sempre válido.

20 de maio de 2024

Serviço de produtos

Adicionamos LoyaltyPrograms. Com essa atualização, é possível oferecer vários níveis com diferentes pontos de fidelidade, preços etc. para um único produto. Use este campo no lugar do campo singular LoyaltyProgram.

Serviço de relatórios

Métricas descontinuadas do Comprar com o Google na tabela MerchantPerformanceView. Depois dessa 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 "Product"

Mudanças no campo "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 um código ou número de certificação.

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

6 de maio de 2024

Serviço de relatórios

Adicionamos o agrupamento de eficácia à tabela PriceInsightsProductView. A eficácia indica quais produtos se beneficiariam mais com as 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 "Product"

Adição dos campos opcionais downpayment e creditType para Pagamentos parcelados:

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

11 de abril de 2024

Serviço de produtos

Recurso "Product"

  • Adicionamos o atributo valor mínimo de frete grátis (FreeShippingThreshold) para frete no nível da oferta. Com esse atributo, os comerciantes podem inserir um preço mínimo do produto para que o frete seja sem custo financeiro.
  • Mudou a visibilidade de LoyaltyPoints

10 de abril de 2024

Serviço de produtos

Recurso "Product"

LoyaltyProgram adicionado

9 de abril de 2024

Serviço de produtos

Recurso "Product"

Adicionamos structuredTitle e structuredDescription para fornecer títulos e descrições de produtos gerados com IA.

3 de abril de 2024

Serviço de suporte ao comerciante

Adicionamos o campo user_input_action_option, que permite aos parceiros solicitar um novo tipo de ação: BuiltInUserInputAction. Com essa ação, os parceiros podem criar funcionalidades complexas de autoatendimento para comerciantes diretamente no aplicativo, sem redirecioná-los ao Merchant Center.

Adição de um novo método TriggerAction para BuiltInUserInputAction. Para acessar esse método, envie uma solicitação neste formulário.

27 de março de 2024

Serviço de produtos

Recurso "Product"

Adicionamos AutoPricingMinPrice 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 menos do que esse valor. Assim, preservando o valor e a lucratividade da oferta.

15 de março de 2024

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

8 de março de 2024

Serviço de relatórios

Adição do relatório TopicTrendsView 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

Adição de um agrupamento 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

Removemos os seguintes valores como origens de conversão válidas:

  • CROSS_CHANNEL_FIRST_CLICK
  • CROSS_CHANNEL_LINEAR
  • CROSS_CHANNEL_POSITION_BASED
  • CROSS_CHANNEL_TIME_DECAY

Removemos as opções de 60 e 90 dias como janela de lookback e adicionamos 40 como uma opção válida.

17 de janeiro de 2024

Serviço de PDV

Adicionamos novos valores ao campo matching_status_hint em PosStore, que permite aos usuários ter mais detalhes sobre por que a correspondência de lojas falhou.

11 de janeiro de 2024

Serviço de contas

Adição de localProductManager e localProductManagement como tipo de link e serviço, respectivamente, para o método link. Elas permitem que as contas sejam vinculadas para gerenciar dados de produtos disponíveis em lojas físicas.

29 de novembro de 2023

Serviço de suporte ao comerciante

Adicionamos 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 para que os usuários saibam o status de correspondência da loja de PDV com a loja do Perfil da Empresa no Google e recebam uma dica para corrigir em caso de problema.

15 de novembro de 2023

Os endpoints repricingrules e repricingrules.repricingreports não são mais compatíveis.

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 identifiquem com determinados valores do consumidor.

10 de Outubro de 2023

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

18 de setembro de 2023

Serviço de configurações de AIL

Adicionamos o método setOmnichannelExperience para permitir que os usuários definam a experiência omnichannel (ou seja, configurações de retirada e vitrine local). Nesse momento, isso 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

Adição da ação integrada FIX_ACCOUNT_ISSUE para problemas com produtos que precisam ser resolvidos no nível da conta. Adicionamos a ação integrada SHOW_ADDITIONAL_CONTENT que será usada para apresentar uma justificativa de uma autoridade nacional.

28 de agosto de 2023

Serviço de promoções

Abra o método list no serviço Promotions do acesso limitado para todos.

22 de agosto de 2023

Serviço de suporte ao comerciante

Lançamos o serviço de suporte ao comerciante. Esse serviço oferece conteúdo de suporte para problemas com a conta e com o 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 junto 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 "Product"

Adição de virtualModelLink para fornecer URLs à imagem do modelo 3D.

4 de julho de 2023

Serviço de produtos

Recurso "Product"

Adicione o campo certifications para fornecer certificações de produtos, por exemplo, para etiquetagem 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

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

29 de maio de 2023

Serviço de promoções

Adição do método list para o 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 Retail

Propriedades adicionais do Cloud Retail

Adicione o campo de propriedades adicionais do varejo na nuvem. Este é um campo repetido destinado a ser usado por 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 "atributos" no modelo de produto do Google Cloud Retail.

22 de maio de 2023

Serviço de promoções

Adição do método list para o 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 configurar as opções para lojas físicas no novo campo storeConfig. Isso inclui o raio de serviço, o horário limite e os códigos das lojas que oferecem entrega local.

3 de abril

Serviço de recomendações

Lançamos o serviço de recomendações. Esse serviço sugere maneiras de melhorar a performance da sua conta de comerciante e permite que você informe cliques de comerciantes em recomendações úteis.

20 de fevereiro de 2023

Serviço de contas

Recurso da conta

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

Serviço ConversionSources

Adicionamos o serviço "Origens de conversão", que permite gerenciar 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 das lojas agora são validados para garantir que pertencem ao comerciante antes que as configurações de frete sejam atualizadas.

Validação de comerciante da LIA

Agora, os programas em que um ID do comerciante está inscrito são validados antes da atualização das configurações de frete. 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

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

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

12 de janeiro de 2023

Serviço de produtos

Recurso "Product"

Adicionamos lifestyleImageLinks para fornecer URLs de imagens de estilo de vida.

24 de novembro de 2022

Serviço de promoção

Adicionamos um novo campo "promotionStatus" na seção Promotions.PromotionStatus. Este é um campo somente leitura.

15 de novembro de 2022

Serviço de relatórios

Adicionamos relatórios do Market Insights ao serviço de relatórios.

Agora é possível consultar o serviço de relatórios para o seguinte:

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

7 de novembro de 2022

Serviço Datafeeds

Adição de suporte a feedLabel para o serviço Datafeeds.

14 de setembro de 2022

Atualização de feedLabel para aceitar qualquer string.

9 de agosto de 2022

Adição de 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 construídos como online:language:feedLabel:offerId.

feedLabel foi preenchido automaticamente com o valor de targetCountry para feeds atuais por 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 no blog O rótulo do feed substitui o país de destino na API Content for 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.

Essa nova seção permite que os comerciantes atualizem itens automaticamente, melhorem 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

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

Adicione o novo campo warehouseName em WarehouseBasedDeliveryTime para se referir ao depósito pelo nome do depósito.

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

Adicionamos 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 extended BuyOnGooglePrograms.BuyOnProgramStatus.

6 de setembro de 2021

Serviço de contas

Recurso da conta

Adicionamos um novo campo "korean_business_registration_number" na 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

Adicionamos um novo serviço de promoção com a opção "Inserir promoção" disponível.

Serviço de pedidos

Adicionamos um novo método orders/captureOrder para capturar fundos antes do envio.

Motivo do cancelamento do novo pedido FAILED_TO_CAPTURE_FUNDS

Serviço de produtos

Recurso "Product"

Adição de productLength, productHeight, productWidth e productWeight para fornecer dimensões e peso do produto.

9 de agosto de 2021

Serviço RepricingRule

Tipo de RepricingRule

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 rotulagem de devoluções de pedidos

Adição de um novo campo "product_id" em CreateReturnRequest. Os comerciantes podem especificar o product_id ou o line_item_id para identificar o item a ser devolvido.

Serviço de produtos

Adicionamos um novo método para atualizar produtos existentes. É possível atualizar um produto fornecendo apenas os campos que precisam ser atualizados em vez do produto inteiro.

3 de maio de 2021

Serviço de rotulagem de devoluções de pedidos

Adicionamos novos métodos para fazer upload de rótulos para devoluções gerenciadas pelo comerciante (MMR, na sigla em inglês). Com o novo orderreturns.labels.create, é possível 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 ao cálculo da data de entrega estimada.

12 de abril de 2021

Serviço de produtos

Recurso "Product"

Novo campo additionalSizeType para aceitar até dois tipos de tamanhos por produto.

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

28 de janeiro de 2021

Serviço de contas

Adicionamos suporte automático a rótulos nos recursos AccountLabel e Account. Para mais informações, consulte a seção Tipos de rótulos do CSS no guia de gerenciamento de rótulos do CSS.

5 de outubro de 2020

Serviço CSSES

Recurso CSS

Adicionamos um novo serviço csses para recuperar informações sobre domínios do 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 do CSS.

24 de agosto de 2020

Serviço de produtos

Recurso "Products"

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

Recurso Productstatuses

Novos campos approvedCountries, pendingCountries e disapprovedCountries no objeto destinationStatuses, que fornecem informações de 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 contas do Merchant Center no CSS Center. Os usuários do CSS Center 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 "Product"

Novos campos

Novos campos productDetails, productHighlights, subscriptionCost e canonicalLink.

2 de junho de 2020

Serviço de pedidos

Adicionamos novos métodos para iniciar reembolsos sem devoluções. Com os novos orders.refunditem e orders.refundorder, é possível iniciar reembolsos de pedidos mesmo que eles não sejam devolvidos pelo cliente.

27 de abril de 2020

Serviço Orderreturns

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

Vinculação do GMB

Adicionamos a capacidade de vincular contas do Merchant Center a uma conta do Google Meu Negócio usando o ID da conta do GMB.

14 de abril de 2020

APIs de relatórios de liquidação

Adição de um novo serviço para receber relatórios de pagamento.

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ções do Pub/Sub

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

3 de dezembro de 2019

Serviço de produtos

Adicionamos suporte para feeds complementares da API Content de contas de múltiplos clientes.

11 de setembro de 2019

Serviço de pedidos

Adição de suporte para retiradas em pedidos e recursos correspondentes do sandbox.

14 de agosto de 2019

Novos serviços

Adicionamos novos serviços Returnpolicy e Returnaddress 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

Adição dos novos campos loyaltyInfo e invoiceReceivingEmail ao recurso "Order".

1º de julho de 2019

Serviço de produtos

Suporte para feeds complementares da API Content adicionado ao serviço Produtos.

11 de junho de 2019

Serviço de pedidos

Recursos Order e TestOrder

Adição de ajuste de preço

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

14 de fevereiro de 2019

Mudanças introduzidas nesta versão

As simulações não são mais compatíveis

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

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
  • Shippingsettings

Remoção de métodos HTTP BATCH

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

  • Contas
  • Accountstatuses
  • Feeds de dados
  • Datafeedstatuses
  • Liasettings
  • Orderreports
  • Pos.
  • Produtos
  • Productstatuses
  • 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 informações sem querer nesses dois campos com update se elas não forem fornecidas.

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

Mudança de marca do Google AdWords para Google Ads

Com a mudança do AdWords para o 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 descontinuado reviewsUrl foi removido. Além disso, o status do link inactive foi removido para adsLinks, googleMyBusinessLink e youtubeChannelLinks.

Serviço Accountstatuses

Recurso AccountStatus

Remoção de dataQualityIssues

Elas foram substituídas por itemLevelIssues.

Serviço de feed de dados

Recurso Datafeed

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:

  • Use os novos feeds complementares para atualizações parciais de produtos.
  • Use o novo serviço localinventory para atualizações de produtos disponíveis na loja física.

Serviço de pedidos

CancelLineItem

Os campos amount, amountPretax e amountTax na 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 pré-tributo ou pós-tributo, dependendo da localização do pedido.

Reembolso

Esse método foi removido. Use returnRefundLineItem.

ReturnLineItem

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

ReturnRefundLineItem

Os campos amountPretax e amountTax foram substituídos por priceAmount e taxAmount, respectivamente. O campo priceAmount pode ser pré-tributo ou pós-tributo, dependendo da localização do pedido.

ShipLineItem

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

Recursos Order 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 e predefinedBillingAddress 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 em Order e TestOrder.

O campo descontinuado customer.email foi removido.

O formato do campo promotions mudou no recurso Order.

Serviço Orderpayments

Esse serviço foi removido da v2.1.

Serviço de produtos

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

  • channel
  • contentLanguage
  • id
  • offerId
  • targetCountry

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 retornada seja o mesmo que o ID da oferta de entrada.

Agora os preços 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 "Product"

CustomGroups substituídos por customAttributes recursivos

Antes, era possível agrupar atributos personalizados adicionando-os ao mesmo grupo personalizado na v2. Os atributos personalizados agora são recursivos na v2.1, o que elimina a necessidade de grupos personalizados.

Agora, os atributos personalizados têm um campo groupValues extra 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 v2 e 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 um máximo de 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 um type e um 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. O primeiro tipo ficava no campo singular productType, e os restantes, no campo repetido additionalProductTypes. Na v2.1, os dois campos foram substituídos por um único campo repetido productTypes.

O atributo "Destinos" foi substituído por "includedDestinations" e "excludedDestinations"

Os destinos foram inseridos como uma lista de pares de nome e intenção de destino na v2 no campo repetido destinations. Esse 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 o 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 Productstatuses

Get e List

O atributo product foi removido, assim como 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 são retornados, sejam válidos ou não. 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 dataQualityIssues

Elas foram substituídas por itemLevelIssues.