15 de novembro de 2024
Serviço de produtos
Para LoyaltyProgram, foi adicionado o campo shipping_label para especificar a qualificação. Se o campo tiver um valor, a oferta terá o benefício de frete do programa de fidelidade. Se o valor do campo não for fornecido, o item não estará qualificado para o frete do programa de fidelidade para o nível de fidelidade especificado.
30 de outubro de 2024
Serviços relacionados a liquidação
Como parte do desligamento das APIs relacionadas a liquidação, os seguintes serviços foram descontinuados:
- settlementreports
- settlementtranscations
O encerramento das APIs relacionadas a liquidação está relacionado ao programa BuyOnGoogle e às APIs relacionadas a pedidos, que foram encerrados anteriormente.
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 com um valor não vazio serão atualizados.
26 de agosto de 2024 (antes do previsto)
Serviços relacionados a pedidos
Como parte do desligamento das APIs relacionadas a pedidos, 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. Com essa atualização, você pode especificar, se aplicável, o período em que o preço do
membro do programa de fidelidade é válido. 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.
Serviço de relatórios
Métricas do Comprar com o Google descontinuadas na tabela
MerchantPerformanceView. Depois dessa atualização, a extração de qualquer métrica do Comprar com o Google retorna 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: foi adicionado
certificationValue
ao campo
ProductCertification
para fornecer o valor da certificação (também conhecido como classe, nível ou grau),
que permite que os usuários façam 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
Adicionado o 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:
downpaymentinforma o valor que o comprador precisa pagar antecipadamente como um pagamento único.creditTypeinforma o tipo de pagamento parcelado (financeoulease). 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 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
LoyaltyPointsfoi 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 do 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.
Um novo método TriggerAction foi adicionado 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 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 rentabilidade 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 fontes de conversão válidas:
CROSS_CHANNEL_FIRST_CLICKCROSS_CHANNEL_LINEARCROSS_CHANNEL_POSITION_BASEDCROSS_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. Elas permitem que as contas sejam vinculadas
para gerenciar dados de produtos locais.
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
Foram adicionados os campos matching_status e matching_status_hint a
PosStore,
que permite que os usuários saibam o status de correspondência da loja de PDV com a loja do Perfil da Empresa no Google e uma sugestão de correção 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 tem mais suporte.
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 em local de coleta é um serviço fornecido por terceiros (por exemplo, não
pertencente ao comerciante) para entregar o item a um local afiliado de 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 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
Serviço de suporte ao comerciante lançado. 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
Foram adicionados 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 de 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 produtos, por exemplo, para
rótulos 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_GOOGLELOCAL_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.
BRESNLJPITKR
12 de janeiro de 2023
Serviço de produtos
Recurso de 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. Este é 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:
- Relatórios de mais vendidos
usando as tabelas
BestSellersProductClusterVieweBestSellersBrandView. - Relatório de competitividade de preço
usando a tabela
PriceCompetitivenessProductView. - Relatório de informações de preços
usando a tabela
PriceInsightsProductView.
Para mais informações, consulte nossos guias de relatórios.
7 de novembro de 2022
Serviço de feeds de dados
Adição de suporte a feedLabel para o serviço de feeds de dados.
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 desativou 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 da API 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.
Adicionamos um novo campo warehouseName em
WarehouseBasedDeliveryTime
para se referir a
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_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
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 de 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. É possível atualizar um produto fornecendo apenas os campos que precisam ser atualizados em vez de todo o produto.
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
do CSS.
24 de agosto de 2020
Serviço de produtos
Recursos de produtos
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 sobre o status da oferta além de
targetCountry.
Novo campo itemLevelIssues.applicableCountries.
10 de agosto de 2020
Serviço de contas
Foi adicionado um novo recurso AccountLabel para gerenciar rótulos de contas do Merchant Center
no 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 de 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ções 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
Um novo serviço foi adicionado para receber relatórios de liquidaçã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
Adição de suporte a feeds complementares da API Content para contas de múltiplos clientes.
11 de setembro de 2019
Serviço de pedidos
Foi adicionado suporte a envios para retirada em 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 ordem e TestOrder
Adição de ajuste de preço
Foi adicionado um novo campo lineItem[].adjustments 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 oferecem mais suporte ao 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 os seguintes:
- Contas
- Accountstatuses
- Feeds de dados
- Status do feed de dados
- Liasettings
- 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:
adwordsLinks->adsLinksadwordsLinks.adwordsId->adsLinks.adsId
Remoção de campos e valores descontinuados
O campo reviewsUrl descontinuado foi removido. Além disso, o status de vinculação
inactive foi removido para adsLinks, googleMyBusinessLink e
youtubeChannelLinks.
Serviço de Accountstatuses
Recurso AccountStatus
Remoção de dados
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:
- Use os novos feeds complementares para atualizações parciais de produtos.
- Use o novo serviço
localinventorypara atualizações de produtos locais.
Serviço de pedidos
CancelLineItem
Os campos amount, amountPretax e amountTax na solicitação foram
removidos. O valor reembolsado agora é calculado automaticamente.
CustomBatch
O 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 em Order e TestOrder.
O campo customer.email descontinuado foi removido.
O formato do campo promotions foi alterado no recurso Order.
Serviço de pagamentos de pedidos
Esse serviço foi removido da v2.1.
Serviço de produtos
A resposta de um insert vai conter apenas os seguintes atributos:
channelcontentLanguageidofferIdtargetCountry
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 será o mesmo que o 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 eles não podem ser
definidos ou excluídos 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 intenção 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.
Como renomear campos relacionados ao AdWords
Com a mudança do AdWords para Google Ads, os seguintes campos relacionados ao AdWords foram renomeados:
adwordsGrouping->adsGroupingadwordsLabels->adsLabelsadwordsRedirect->adsRedirect
Remoção de campos descontinuados
Os seguintes campos descontinuados foram removidos:
aspectsdestinationsonlineOnlyvalidatedDestinationswarnings
Serviço de status dos produtos
Receber 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.