Este documento apresenta diretrizes para a criação de uma origem de dados de produtos XML no formato Atom 0.3. Relacionamos os atributos padrão a suas respectivas seções na especificação Atom 0.3 oficial para ajudar você 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 na norma Atom 0.3, eles são obrigatórios para sua origem de dados de produtos.
A origem de dados de produtos também requer outros elementos, como preço e estado. 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 produto da origem.
Confira 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 da sua origem de dados de produtos</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ã vermelha</title> <link href="http://www.example.com/item1-info-page.html" /> <summary>Este suéter confortável e macio é ideal para manter você aquecido nas noites frias de 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 mais informações sobre os produtos usando esses atributos aumenta muito as chances de eles 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 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:
O nome do arquivo precisa terminar com a extensão .xml.
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.
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.
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.
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 do Google Merchant Center. Embora sejam aceitas origens de dados de produtos que contenham outros elementos definidos no padrão Atom 0.3 ou no próprio namespace, qualquer informação que esses elementos contenham será ignorada durante o processamento e não aparecerá nas suas listagens. 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.