Em março de 2019, lançamos a versão 2.1 da API Content for Shopping e, em abril de 2021, anunciamos que a v2 seria desativada em 30 de setembro de 2021. A versão v2 foi descontinuada. Migre para a v2.1 imediatamente.
Migrar seu aplicativo
Migrar da v2 para a v2.1 envolve a atualização dos URLs do endpoint para chamar as novas versões da v2.1 e a modificação dos aplicativos para considerar as alterações interruptivas introduzidas na v2.1.
Atualizar suas chamadas de API para usar endpoints v2.1
Para fazer chamadas para a v2.1, atualize suas solicitações para usar os novos endpoints da v2.1.
Por exemplo, para chamar o método products.get
com a v2, você usaria:
GET https://shoppingcontent.googleapis.com/content/v2/merchantId/products/productId
Para a v2.1, atualize o URL para:
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products/productId
Para ver informações completas sobre os serviços e endpoints v2.1, consulte a Referência da API.
Faça as alterações necessárias
Além de atualizar os URLs para suas chamadas de API, você também precisa atualizar seu aplicativo para considerar várias alterações interruptivas introduzidas na v2.1. Leia as seções a seguir e atualize sua inscrição, conforme necessário.
1. Atualizar integrações com o serviço inventory
O serviço inventory
v2 foi removido, e a funcionalidade equivalente está disponível com os seguintes recursos da v2.1:
Use novos feeds suplementares ou
products.update
para atualizações parciais do produto. É possível fazer atualizações em todos os campos de produtos mutáveis, incluindo aqueles que foram atualizados anteriormente cominventory.set
(exceto aqueles exclusivos paralocalinventory
). Consulte Migrar para feeds suplementares para mais detalhes.Use o novo serviço
localinventory
para atualizações de produtos disponíveis na loja física.
2. Atualizar chamadas para o serviço accounts
As chamadas para o método
accounts.update
na v2.1 substituem completamente o recursoaccounts
, em vez de apenas atualizar os campos incluídos na solicitação. Para evitar a exclusão de campos no recursoaccounts
, atualize suas solicitações de chamada para incluir todos os campos.O
reviewsUrl
foi removido.O status
inactive
do link foi removido paraadsLinks
,googleMyBusinessLink
eyoutubeChannelLinks
.
3. Atualizar chamadas para o serviço products
Os atributos personalizados não contêm mais um tipo e uma unidade. Em vez disso, as unidades precisam ser anexadas ao valor, e os tipos são detectados automaticamente.
O campo repetido
productTypes
substituiuproductType
eadditionalProductTypes
.Os campos repetidos
includedDestinations
eexcludedDestinations
substituíram o campo repetidodestinations
.Os seguintes campos relacionados ao Google AdWords foram renomeados:
adwordsGrouping
->adsGrouping
adwordsLabels
->adsLabels
adwordsRedirect
->adsRedirect
Os seguintes campos foram removidos:
aspects
destinations
onlineOnly
validatedDestinations
warnings
O parâmetro
includeInvalidInsertedItems
foi removido. Na v2.1, todos os produtos são retornados por padrão.Agora há um atraso de alguns minutos antes que o produto inserido possa ser recuperado via
products.get
ouproducts.list
.Não há mais garantia de que o
offerId
retornado seja o mesmo que oofferId
de entrada. A v2.1 corta os espaços em branco à esquerda e à direita noofferId
e mescla vários caracteres de espaço em branco em um. Essa mudança não afeta os valores deofferId
que estão em conformidade com a sintaxeofferId
recomendada.Agora os preços são validados antes da inserção do produto. Apenas os seguintes caracteres são permitidos na string de valor:
+
,-
,.
e dígitos (ou seja,0
-9
). vírgulas não são mais aceitas.As respostas de uma chamada
products.insert
ouproducts.update
contêm apenas os seguintes atributos:channel
contentLanguage
id
offerId
feedLabel
A opção
includeAttributes
da v2 foi descontinuada. Em vez disso, useproducts.get
comProductId
para conferir as informações completas do produto.
4. Atualizar chamadas para o serviço productstatuses
O atributo
product
e o parâmetroincludeAttributes
foram removidos. Para recuperar os atributos do produto correspondente a um status, use o serviçoproducts
e transmita o valor do novo campoproductId
.O parâmetro
includeInvalidInsertedItems
foi removido. OproductId
de cada produto agora é retornado, independente de o produto ser válido ou não.Os campos
intention
,approvalStatus
eapprovalPending
emdestinationStatuses
foram substituídos porstatus
, que é uma string que pode serapproved
,disapproved
oupending
.dataQualityIssues
foi substituído poritemLevelIssues
.
5. Atualizar chamadas para o serviço datafeeds
Os seguintes campos de destino foram substituídos:
contentLanguage
->language
targetCountry
->country
intendedDestinations
->includedDestinations
eexcludedDestinations
Os feeds de dados com
contentType = "product inventory update"
foram removidos.
6. Atualizar chamadas para os serviços orders
e TestOrders
Na v2.1, as chamadas não devem incluir dados fiscais, porque eles são calculados automaticamente. Se o pedido for atendido em um estado com uma Lei de Imparcialidade (MFA) do Marketplace ou semelhante, as chamadas que incluírem dados fiscais falharão. Se o pedido for realizado em um estado que não seja MFA, o tributo será calculado com base nas configurações definidas no Merchant Center. Se não for configurado, o tributo calculado vai ser 0.
Os campos
InStoreRefundLineItem
eReturnRefundLineItem
amountPretax
eamountTax
foram substituídos porpriceAmount
etaxAmount
, respectivamente. OpriceAmount
pode ser com ou sem tributos, dependendo da localização do pedido.Os campos
ShipLineItem
carrier
,shipmentId
etrackingId
na solicitação foram movidos parashipmentInfos
.billingAddress
epredefinedBillingAddress
agora são campos de nível superior emorders
eTestOrder
, respectivamente.customer.explicitMarketingPreference
foi substituído porcustomer.marketingRightsInfo
.O campo
netAmount
foi dividido emnetPriceAmount
enetTaxAmount
.shippingOption
foi substituído porlineItems[].shippingDetails
.Os campos
CancelLineItem
amount
,amountPretax
eamountTax
na solicitação foram removidos. O valor reembolsado agora é calculado automaticamente.O
CustomBatch
foi removido.O
Refund
foi removido. UserefundOrder
ourefundItem
.O campo
paymentMethod
foi removido.Os métodos
orders.returnlineitem
eorders.refund
da v2 foram substituídos pororderreturns.creatOrderReturn
eorderreturns.process
.Os campos
customer.email
,channelType
elineItem.product.channel
foram removidos.O campo
promotions
foi removido do serviçoTestOrder
, e o formato dele foi alterado emOrder
.
7. Atualizar chamadas para o serviço orderinvoice
Os campos
amountPretax
eamountTax
foram substituídos porpriceAmount
etaxAmount
, respectivamente. O campopriceAmount
pode ser sem tributos ou sem tributos, dependendo do local do pedido.Removemos os saldos (comerciante, cliente, Google) em
invoiceSummary
e campos relacionados à cobrança de promoção.
8. Remover a funcionalidade não incluída na v2.1
Vários outros recursos foram removidos da API Content na v2.1. Consulte a lista a seguir e atualize seu aplicativo, conforme necessário:
O suporte a XML não é mais oferecido. Para mais informações sobre como mudar para JSON, consulte Desativação do suporte a XML na API Content for Shopping.
O parâmetro
dryRun
foi removido. Essa mudança se aplica a todas as chamadas de API.Todos os métodos
HTTP BATCH
foram removidos. UsecustomBatch
.O método
patch
foi removido dos seguintes serviços:accounts
accounttax
datafeeds
liasettings
shippingsettings
O serviço
orderpayments
foi removido.
Testar a migração
Para mais informações sobre como testar as alterações nos aplicativos após a migração para a v2.1, consulte Como testar usos da API Content for Shopping. Se você encontrar problemas ao testar as atualizações, poste seu problema no fórum da API Content.
Outras mudanças na v2.1
Além das alterações que exigem atualizações, a v2.1 também apresenta vários novos recursos e alterações não interruptivas:
Novos serviços:
O novo serviço
localinventory
permite fazer atualizações de produtos disponíveis na loja física (no lugar do serviçoinventory
na v2).O novo serviço
orderreturns
facilita o gerenciamento do Comprar com o Google (anteriormente conhecido como Ações do Shopping), permitindo que você processe devoluções sem precisar usar o serviçoorders
.
Os feeds complementares permitem fazer atualizações parciais do produto.
Outras mudanças no serviço
products
:As solicitações
products.insert
não informam mais avisos ou erros não fatais. Assim, é possível inserir produtos e fazer atualizações para resolver problemas usando regras de feed no Merchant Center, assim como você faria com feeds gerenciados fora da API Content.products.update
foi adicionado para permitir que você faça atualizações em um conjunto escolhido de campos de produtos. Para mais informações sobre possíveis usos, consulte o guia.Valores inválidos para os atributos abaixo não acionam mais erros de inserção e são retornados como parte de
itemLevelIssues
pelo serviçoproductstatus
:ageGroup
availability
condition
energyEfficiencyClass
gender
maxEnergyEfficiencyClass
minEnergyEfficiencyClass
sizeSystem
sizeType
Os atributos personalizados agora são recursivos, o que elimina a necessidade de grupos personalizados.
Os atributos personalizados agora têm um campo
groupValues
além do campovalue
original. Exatamente um dos campos deve ser definido.