Especificação RSS 2.0

Este documento apresenta diretrizes para a criação de uma origem de dados de produtos XML no formato RSS 2.0. Relacionamos os atributos padrão a suas respectivas seções na especificação RSS 2.0 oficial para ajudar você a encontrar informações adicionais sobre os componentes de nossos exemplos. Embora forneçamos exemplos de arquivos RSS 2.0, damos poucos detalhes sobre o RSS 2.0 em si. Se você quiser saber mais sobre esse padrão, consulte esta especificação.

Observação: inclua na sua origem RSS todos os produtos que você quer inserir no Google Merchant Center, e não só as mudanças recentes feitas nos seus itens. Se você remover um produto da origem de dados de produtos RSS, ele vai ser excluído do Google Merchant Center.

Seção 1: RSS 2.0

Com base na especificação RSS 2.0, há três elementos predefinidos em cada item: título, link e descrição. Embora esses elementos sejam opcionais na norma RSS 2.0, são necessários em origens de dados de produtos.

As origens de dados de produtos também exigem elementos extras como preço, código e estado. Para incluir esses elementos e informações mais detalhadas sobre um item, ampliamos o RSS 1.0 acrescentando o namespace do Google Merchant Center. Ao definir o namespace do Google Merchant Center, você pode usar outros elementos conhecidos como "atributos", além de aumentar a quantidade de informações fornecidas para cada item da origem de dados de produtos.

Confira abaixo um exemplo de documento padrão RSS 2.0 com apenas um item: As duas principais adições nesse exemplo são a declaração de namespace (xmlns:g="http://base.google.com/ns/1.0") e a inclusão de quatro atributos (link da imagem [image_link], preço [price], estado [condition] e código [id]).

<?xml version="1.0"?>
<rss xmlns:g="http://base.google.com/ns/1.0" version="2.0">
<canal>
<title>Exemplo: Google Store</title>
<link>https://store.google.com</link>
<description>Este é um exemplo de um documento padrão RSS 2.0 com apenas um item</description>
<item>

<g:id>TV_123456</g:id>
<g:title>Google Chromecast com Google TV</g:title>
<g:description>Você assiste o que mais gosta com o Chromecast com Google TV em até 4K HDR</g:description>
<g:link>https://store.google.com/product/chromecast_google_tv</g:link> <g:image_link>https://images.example.com/TV_123456.png</g:image_link> <g:condition>novo</g:condition>
<g:availability>in_stock</g:availability>
<g:price>49,99 USD</g:price>
<g:shipping>

<g:country>EUA</g:country>
<g:service>Padrão</g:service>
<g:price>7,99 USD</g:price>

</g:shipping>
<g:gtin>123456789123</g:gtin>
<g:brand>Google</g:brand>

</item>
</channel>
</rss>

Faça o download do arquivo de exemplo para informações mais detalhadas sobre uma origem de dados de produtos XML no RSS 2.0.

Faça o download do exemplo de RSS 2.0 (link em inglês)

Declaração de namespace do Google Merchant Center

A declaração de namespace a seguir é obrigatória para o uso dos atributos definidos somente no namespace do Google Merchant Center.

xmlns:g="http://base.google.com/ns/1.0"

Além de declarar o namespace do Google Merchant Center, inclua também um prefixo em cada tag de atributo. Adicionamos esse prefixo para diferenciar os atributos no nosso namespace dos elementos definidos no RSS 2.0. O prefixo selecionado para essa declaração de namespace é "g":

<g:image_link>http://google.com/images/google_sm.gif</g:image_link>

Os atributos do namespace do Google Merchant Center precisam incluir o prefixo ou os atributos, e todos os valores contidos neles vão ser ignorados.

Atributos

Você pode usar todos os atributos relevantes que forem específicos aos seus produtos. Fornecer mais informações sobre os itens usando esses atributos aumenta drasticamente as chances do produto aparecer nos anúncios do Shopping e nas listagens gratuitas quando um cliente fizer uma pesquisa no Google. Além disso, muitos atributos definidos no namespace do Google Merchant Center podem ser usados mais de uma vez no mesmo produto. Isso permite que você adicione mais informações disponíveis sobre um produto na sua origem.

Seção 2: lista de verificação importante

Antes de enviar a origem de dados de produtos, recomendamos que você consulte a lista a seguir para verificar se o arquivo está formatado corretamente:

Step 1 O nome do arquivo precisa terminar com a extensão .xml.

Step 2 O nome de arquivo da origem de dados de produtos que você registrar na sua conta do Google Merchant Center precisa corresponder ao nome que você der ao arquivo.

Step 3 Inclua as declarações de namespace. Esses valores precisam corresponder exatamente aos demonstrados.

Namespace do Google Merchant Center: xmlns:g="http://base.google.com/ns/1.0".
Namespace de atributos personalizados: xmlns:[prefix]="http://base.google.com/cns/1.0", em que [prefix] é substituído pelo prefixo que você incluiu no arquivo.

Step 4 Verifique se o prefixo incluído nas tags de atributos do Google Merchant Center (inclusive as personalizadas) correspondem ao definido na declaração de namespace.

Step 5 Remova os atributos que não contiverem valores.

Seção 3: observação final

A entrada de exemplo incluída neste documento foi simplificada para esclarecer os fundamentos da criação de uma origem de dados de produtos XML. Embora sejam aceitas origens de dados de produtos que contenham outros elementos definidos no padrão RSS 2.0 ou no próprio namespace, qualquer informação que esses elementos contenham será ignorada durante o processamento e não aparecerá nos seus anúncios ou listagens. No momento, só processamos os dados contidos nos elementos padrão do RSS 1.0 e nos atributos dos namespaces do Google Merchant Center, inclusive os personalizados.

Isso foi útil?

Como podemos melhorá-lo?