Migrar para os rótulos do feed

Gostaríamos de apresentar a versão Beta da API Merchant. Esta é a nova versão da API Content e o futuro.

É possível usar o campo feedLabel para adicionar um rótulo aos seus produtos e feeds de dados.

Os rótulos do feed podem ter o seguinte formato:

• String de tipo
• Menor ou igual a 20 caracteres
• Letras maiúsculas (A-Z)
• números (0-9)
• Traços (-)

feedLabel está disponível nos seguintes recursos:

• products
• datafeeds
• datafeedstatuses

ID REST

feedLabel substitui targetCountry em IDs REST para novos produtos.

Em vez de online:language:targetCountry:offerId, o ID REST agora é formado como online:language:feedLabel:offerId para novos produtos. Isso não altera o ID REST dos produtos existentes.

Acessar e listar produtos

O campo feedLabel é sempre preenchido para todos os produtos retornados.

Se feedLabel for um código de território CLDR válido, preencheremos automaticamente o campo targetCountry para compatibilidade. Se feedLabel não for um código de território CLDR válido, deixe targetCountry em branco.

Aviso :os valores targetCountry preenchidos não permitem que seus produtos sejam veiculados no país informado. Verifique se todos os países que você quer segmentar estão incluídos no campo shipping.

As mesmas mudanças se aplicam a endpoints productstatuses.

Os campos específicos do país ficam vazios para ofertas com um feedLabel que não seja um código de território CLDR.

Inserir e atualizar produtos

É necessário usar feedLabel ou targetCountry para inserir novos produtos. Se você inserir ou atualizar produtos com feedLabel e targetCountry, os valores deles precisarão ser iguais.

Você receberá um erro da API se os dois campos estiverem vazios ou se os valores deles não corresponderem.

Consulte Usar rótulos do feed para anunciar produtos de feeds específicos se quiser mais detalhes.

Segmentação por país

Use uma das seguintes opções para garantir que seus produtos sejam segmentados para os países certos:

• Campo shipping do recurso products
• Campo targetCountries do recurso datafeeds

Produtos

O campo targetCountry para products foi descontinuado. Em vez disso, use o campo shipping para especificar os países de destino.

Se você quiser segmentar vários países, poderá continuar usando shipping para adicionar outros países.

Consulte Como segmentar anúncios em vários países para mais informações.

Feeds de dados

Agora é possível ver para quais países um datafeed segmenta explicitamente em targets. Isso se aplica quando você usa feedLabel em vez de country na configuração datafeedtarget.

Também adicionamos o campo targetCountries para datafeeds. Assim, é possível configurar a segmentação para datafeeds diretamente. Você ainda pode configurar a segmentação fora do feed, por exemplo, definindo o atributo shipping do recurso de produtos.

Conversão do Reino Unido para GB

No momento, permitimos o valor UK para o campo targetCountry, mesmo que ele não seja um código de país válido. Convertemos UK automaticamente em GB. Os produtos com UK como targetCountry são armazenados com GB no ID REST e offerId.

Se você definir UK como o valor de feedLabel, ele não será convertido automaticamente em GB. UK e GB são strings diferentes para feedLabel e criam ofertas diferentes.

Se você inserir um targetCountry de UK e o convertermos em GB, será necessário atualizar o ID REST do produto para incluir GB em vez de UK para extrair o produto com o método get.