Especificação Atom 0.3

Este documento apresenta as diretrizes para a criação de um feed de dados do produto XML no formato Atom 0.3. Relacionamos os atributos padrão a suas respectivas seções na especificação Atom 0.3 oficial para ajudá-lo a encontrar informações adicionais sobre os componentes de nossos exemplos. Fornecemos exemplos de arquivos de Atom 0.3, mas apresentamos poucos detalhes sobre o Atom 0.3 em si.

Seção 1: Atom 0.3

De acordo com a especificação Atom 0.3, há quatro elementos básicos predefinidos: título, link, ID e modificação. Embora esses elementos sejam opcionais no padrão Atom 0.3, são necessários em seu feed de dados.

Seu feed de dados também requer elementos adicionais, como preço e condição. Para incluir esses elementos e informações mais detalhadas sobre um produto, estendemos o Atom 0.3 adicionando o namespace do Google Merchant Center. Definir o namespace do Google Merchant Center permite que você use elementos adicionais, conhecidos como "atributos", além de aumentar a quantidade de informações que é possível fornecer sobre cada item do feed.

Veja abaixo um exemplo de documento Atom 0.3 básico, com apenas um produto:

<?xml version="1.0"?>
<feed version="0.3" xmlns="http://purl.org/atom/ns#"

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

<title>O nome do seu feed de dados</title> <link href="http://www.example.com" rel="alternate" type="text/html" /> <modified>2005-10-11T18:30:02Z</modified> <author> <name>Google</name> </author> <id>tag:google.com,2005-10-15:/support/products</id> <entry> <title>Suéter de lã vermelho</title> <link href="http://www.example.com/item1-info-page.html" /> <summary>Confortável e macio, este suéter manterá você aquecido nas noites frias do inverno.</summary> <id>tag:google.com,2005-10-15:/support/products</id> <issued>2005-10-13T18:30:02Z</issued> <modified>2005-10-13T18:30:02Z</modified>

<g:image_link>http://www.example.com/image1.jpg</g:image_link> <g:price>25</g:price> <g:condition>new</g:condition>

</entry> </feed>

As duas principais adições nesse exemplo são a declaração de namespace (na terceira linha) e a inclusão de três atributos (link da imagem [image_link], preço [price] e estado [condition]).

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, você também deve incluir um prefixo em cada tag de atributo. Adicionamos esse prefixo aos atributos para diferenciar os atributos em nosso namespace dos elementos definidos no Atom 0.3. O prefixo selecionado para essa declaração de namespace é "g":

<g:image_link>http://www.example.com/image1.jpg</g:image_link>

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

Atributos

Você pode usar todos os atributos relevantes que forem específicos aos seus produtos. Fornecer informações adicionais sobre os produtos por meio desses atributos aumenta consideravelmente as chances deles aparecerem nos resultados. 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 no seu feed.

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

Antes de enviar seu feed, recomendamos conferir os itens da seguinte lista para garantir a formatação correta do seu arquivo:

1. O nome do arquivo deve terminar com a extensão .xml.
2. O nome de arquivo do feed que você registrar em sua conta do Google Merchant Center deve corresponder ao nome que você der ao arquivo.
3. Lembre-se de incluir as declarações de namespace. Esses valores precisam corresponder exatamente aos demonstrados.
   1. Namespace do Google Merchant Center: xmlns:g="http://base.google.com/ns/1.0".
   2. 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.
4. Verifique se o prefixo incluído nas tags de atributo do Google Merchant Center e do Custom Google Merchant Center correspondem ao prefixo definido na declaração de namespace.
5. Remova os atributos que não contiverem valores.

Seção 3: observação final

O exemplo de entrada incluído neste documento foi simplificado para que houvesse foco claro nos fundamentos da construção de um feed de dados XML do Google Merchant Center. Os feeds contenham outros elementos definidos na norma Atom 0.3 ou em seu próprio namespace são aceitos, mas qualquer informação que esses elementos contiverem serão ignoradas durante o processamento e não aparecerão em suas informações do produto. No momento, processaremos somente os dados contidos nos elementos padrão do Atom 0.3 e em atributos dos namespaces do Google Merchant Center e do Custom Google Merchant Center.