Esta seção descreve o esquema XML usado para o feed de dados da avaliação do comerciante.
Elemento de nível superior: <feed>
Descrição
É o principal elemento de contêiner que contém todos os outros elementos do feed.
Atributos
| Nome | Formatar | Ocorrências | Descrição |
|---|---|---|---|
xmlns
|
x:string | Obrigatório (1) | Codifique o seguinte valor:http://schemas.google.com/merchant_reviews/5.0
|
xmlns:xsi
|
x:string | Obrigatório (1) | Codifique o seguinte valor:http://www.w3.org/2001/XMLSchema-instance
|
xsi:schemaLocation
|
x:string | Obrigatório (1) | Codifique o valor a seguir, deixando um único espaço em branco entre os URLs:http://schemas.google.com/merchant_reviews/5.0 http://www.gstatic.com/productsearch/static/reviews/5.0/merchant_reviews.xsd
|
Exemplo
<feed xmlns="http://schemas.google.com/merchant_reviews/5.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://schemas.google.com/merchant_reviews/5.0 https://www.gstatic.com/productsearch/static/reviews/5.0/merchant_reviews.xsd">
Contém
| Nome | Formatar | Ocorrências | Descrição |
|---|---|---|---|
merchants |
- -- | Opcional (0 a 1) | Elemento do contêiner para elementos <merchant>. |
deleted_merchants |
- -- | Opcional (0 a 1) | Elemento do contêiner para elementos <deleted_merchant>. |
reviews |
- -- | Opcional (0 a 1) | Elemento do contêiner para elementos <review>. |
deleted_reviews |
- -- | Opcional (0 a 1) | Elemento do contêiner para elementos <deleted_review>. |
<merchants>
Descrição
Contêiner para elementos <merchant>.
Contém
| Nome | Formatar | Ocorrências | Descrição |
|---|---|---|---|
merchant |
- -- | Obrigatório (1‐n) | Elemento repetido para cada comerciante. |
<merchant>
Descrição
Cada elemento <merchant> contém informações e avaliações de um comerciante.
Atributos
| Nome | Formatar | Ocorrências | Descrição |
|---|---|---|---|
id |
Código | Obrigatório (1) | Precisa ser exclusivo e estável em todos os feeds. Em outras palavras, se um feed de hoje e um de 90 dias atrás se referem ao mesmo comerciante, ele precisa ter o mesmo ID. |
Exemplo
<merchant id="2739">
Contém
Inclua os seguintes elementos no elemento do comerciante.
| Nome | Formatar | Ocorrências | Descrição |
|---|---|---|---|
name |
NonEmptyString (link em inglês) | Obrigatório (1) | Nome de exibição legível do comerciante. |
merchant_url
|
xs:anyURI | Obrigatório (1) | URL para o site principal do comerciante. Não use um URL de redirecionamento para esse valor. Em outras palavras, o valor precisa apontar diretamente para o site do comerciante. Exemplo: <merchant_url> http://store.google.com </merchant_url> |
rating_url
|
xs:anyURI | Obrigatório (1) | URL para a página de destino que hospeda as avaliações deste comerciante. Não use um URL de redirecionamento. Exemplo: <rating_url> http://merchant_url.com/reviews/ </rating_url> |
create_timestamp
|
DateTimeWithTimeZone (em inglês) | Obrigatório (1) | Hora/data em que o comerciante foi criado. Isso nunca mudará. |
last_update_timestamp
|
DateTimeWithTimeZone (em inglês) | Obrigatório (1) | Hora/data da última atualização do comerciante. Se algum dos campos no elemento <merchant>
for atualizado para um determinado ID do comerciante, esse valor também vai precisar mudar.
|
<deleted_merchants>
Descrição
Contêiner para comerciantes que foram excluídos.
Contém
| Nome | Formatar | Ocorrências | Descrição |
|---|---|---|---|
deleted_merchant |
- -- | Obrigatório (1‐n) | Contém elementos relacionados a um único comerciante excluído. |
<deleted_merchant>
Descrição
Comerciante que foi excluído.
Atributos
| Nome | Formatar | Ocorrências | Descrição |
|---|---|---|---|
id
|
Código | Obrigatório (1) | Especifica o ID do comerciante que precisa ser excluído do feed. O ID precisa corresponder ao
atributo id de um elemento <merchant> em qualquer arquivo de feed anterior.
|
Contém
| Nome | Formatar | Ocorrências | Descrição |
|---|---|---|---|
last_update_timestamp
|
DateTimeWithTimeZone (em inglês) | Obrigatório (1) | Hora/data em que um comerciante foi removido do sistema.
Exemplo: <last_update_timestamp> 2016-04-03T18:37:32Z </last_update_timestamp> |
Exemplo
<deleted_merchant id="10"> <last_update_timestamp>2014-07-12T07:55:06Z</last_update_timestamp> </deleted_merchant>
<reviews>
Descrição
Contêiner para elementos <review>.
Contém
| Nome | Formatar | Ocorrências | Descrição |
|---|---|---|---|
review
|
- -- | Obrigatório (1‐n) | Elemento repetido para cada avaliação. |
<review>
Descrição
Contêiner com detalhes relacionados a uma avaliação.
Atributos
| Nome | Formatar | Ocorrências | Descrição |
|---|---|---|---|
id
|
Código | Obrigatório (1) | O identificador para uma avaliação no seu sistema. Precisa ser exclusivo e estável em todos os feeds.
Exemplo: <review id=132739 mid=1234> |
mid
|
Código | Obrigatório (1) | O identificador do comerciante a que esta avaliação se destina. |
Contém
Inclua os seguintes elementos no elemento de avaliação.
| Nome | Formatar | Ocorrências | Descrição |
|---|---|---|---|
reviewer_name
|
NonEmptyString (link em inglês) | Opcional (0 a 1) | Nome de exibição do autor da avaliação, contanto que a avaliação tenha um autor nomeado.
Avaliações anônimas não devem incluir este campo.
Exemplo: <reviewer_name> Joel </reviewer_name> |
create_timestamp
|
DateTimeWithTimeZone (em inglês) | Obrigatório (1) | Hora/data em que o comentário foi enviado pelo usuário. Isso nunca mudará.
Exemplo: <create_timestamp> 2016-04-03T18:37:32Z </create_timestamp> |
last_update_timestamp
|
DateTimeWithTimeZone (em inglês) | Obrigatório (1) | Hora/data das últimas mudanças no elemento <review>. Se algum dos campos
no elemento <review> for atualizado para um determinado ID de avaliação, esse valor também precisará ser alterado.
Exemplo: <last_update_timestamp> 2016-04-03T18:37:32Z </last_update_timestamp> |
country_code
|
CountryCode | Obrigatório (1) | País do avaliador. Se disponível, esse é o país para onde o produto foi enviado ou
onde o serviço foi renderizado. Caso contrário, use o país em que o avaliador está no momento de
criar a avaliação. O código do país precisa estar no
formato ISO 3166-1 alfa-2.
Exemplo: <country_code>
US
</country_code>
|
title
|
x:string | Opcional (0 a 1) | É o título da avaliação. O título deve ser um texto simples sem tags HTML.
Exemplo: <title>
Great prices
</title>
|
content
|
x:string | Obrigatório (1) | Conteúdo da avaliação. Qualquer texto de formato livre fornecido pelo usuário não pode
ser truncado. O conteúdo precisa ser de texto simples sem tags HTML. Por exemplo, uma quebra de linha precisa ser representada por um caractere de feed de linha, não por uma tag <br>
Se várias respostas para diferentes perguntas forem fornecidas, todas elas precisarão ser incluídas, com o contexto mínimo de resposta. Não forneça
contexto se as perguntas não foram respondidas.
Exemplo: <content>
I like this store!
My order arrived on time and I got
a great price.
</content>
Exemplo: <content>
Positives: Great prices.
Suggestions: Selection could be better.
</content>
|
ratings
|
-- | Obrigatório (1) | Elemento do contêiner para as avaliações do comerciante. Se nenhuma classificação estiver disponível para o elemento <overall>, a avaliação associada completa deverá ser excluída do feed porque o elemento <overall> é obrigatório e a avaliação não será aceita sem ele.
|
collection_method
|
CollectionMethodType | Obrigatório (1) | É o método usado para coletar a avaliação. O valor precisa ser um destes:
Exemplo: <collection_method>
after_fulfillment
</collection_method>
|
<ratings>
Descrição
Contém as classificações do comerciante. Se nenhuma classificação estiver disponível para o elemento <overall>, toda a avaliação associada deverá ser excluída do feed, porque o elemento <overall> é obrigatório e a avaliação não será aceita sem ele.
Contém
Inclua os seguintes elementos no elemento de classificações.
| Nome | Formatar | Ocorrências | Descrição |
|---|---|---|---|
overall
|
Intervalo de classificação | Obrigatório (1) | A classificação geral do avaliador para um comerciante.
Exemplo: <overall min="1" max="10">9</overall> |
customer_service
|
Intervalo de classificação | Opcional (0 a 1) | É a avaliação do avaliador sobre a qualidade do atendimento ao cliente para este comerciante.
Exemplo: <customer_service min="1" max="5">3</customer_service> |
<deleted_reviews>
Descrição
Contêiner com avaliações que foram excluídas.
Contém
| Nome | Formatar | Ocorrências | Descrição |
|---|---|---|---|
deleted_review
|
- -- | Obrigatório (1‐n) | Contém elementos relacionados a uma única avaliação excluída. |
<deleted_review>
Descrição
A avaliação que foi excluída.
Atributos
| Nome | Formatar | Ocorrências | Descrição |
|---|---|---|---|
id
|
Código | Obrigatório (1) | Especifica o ID de uma avaliação que será excluída do feed. O ID precisa corresponder ao
atributo de ID de um elemento <review> em qualquer arquivo de feed.
|
Contém
| Nome | Formatar | Ocorrências | Descrição |
|---|---|---|---|
last_update_timestamp
|
DateTimeWithTimeZone (em inglês) | Obrigatório (1) | Hora em que uma avaliação foi removida do sistema.
Exemplo: <last_update_timestamp>
2016-04-03T18:37:32Z
</last_update_timestamp>
|
Exemplo
<deleted_review id="10"> <last_update_timestamp>2014-07-12T07:55:06Z<last_update_timestamp> </deleted_review>