Esquema da tabela de produtos do Google Merchant Center

Esquema em tabela de produtos e problemas de produtos

Quando os dados de relatórios do Google Merchant Center são transferidos para o BigQuery, o formato dos dados de produtos e de problemas de produtos corresponde principalmente ao formato dos campos pertinentes dos recursos de Products e Productstatuses da API Content.

Os dados são gravados em uma tabela chamada Products_merchant_id se você estiver usando um ID do comerciante individual ou Products_aggregator_id se você estiver usando uma conta da MCA.

Observação: a partir de outubro de 2021, os relatórios do Merchant Center não retornarão um valor (NULL) nas tabelas do BigQuery para os campos a seguir: :

• target_country
• destinations.status

Isso faz parte de uma mudança que permitirá segmentar vários países. As informações sobre o status de um produto e os problemas correspondentes agora são específicas de cada país. Em vez de target_country e destinations.status, use os seguintes campos para ler o status de cada país segmentado:

• destinations.approved_countries
• destinations.pending_countries
• destinations.disapproved_countries

Além disso, agora é possível aplicar problemas a países de destino específicos. O campo a seguir indica a quais países um problema se aplica:

• issues.applicable_countries

A tabela Products_ tem o seguinte esquema:

Coluna	Tipo de dados BigQuery	Descrição
product_data_timestamp	TIMESTAMP	Carimbo de data/hora dos dados do produto
product_id	STRING	ID REST da API Content do produto no formato: channel:content_language:feed_label:offer_id
merchant_id	INTEGER	ID da conta do comerciante
aggregator_id	INTEGER	ID da conta do agregador para contas de múltiplos clientes
offer_id	STRING	Um identificador exclusivo do item
title	STRING	Título do item
description	STRING	Descrição do item
link	STRING	URL que leva diretamente à página do item em seu site
mobile_link	STRING	URL de uma versão da página de destino otimizada para dispositivos móveis
image_link	STRING	URL de uma imagem do item
additional_image_links	STRING, REPEATED	Outros URLs de imagens do item
content_language	STRING	O código de idioma ISO 639-1 do item
target_country*	STRING	O código de território CLDR do item
feed_label	STRING	O rótulo do feed para o item ou "-" se não for fornecido
channel	STRING	O canal do item, "online" ou "local"
expiration_date	TIMESTAMP	Data e hora em que o item deve expirar, conforme especificado no momento da inserção
google_expiration_date	TIMESTAMP	Data e hora em que o item expira no Google Shopping
adult	BOOLEAN	Definido como "true" se o item for voltado a adultos
age_group	STRING	Grupo etário alvo do item
availability	STRING	Status de disponibilidade do item
availability_date	TIMESTAMP	Data e hora em que um produto de pré-encomenda fica disponível para entrega
brand	STRING	Marca do item
google_brand_id	STRING	Código da marca do Google para o item
color	STRING	Cor do item
condition	STRING	Condição ou estado do item
custom_labels	RECORD	Rótulos personalizados para agrupamento personalizado de itens em uma campanha do Shopping
custom_labels.label_0	STRING	Rótulo personalizado 0
custom_labels.label_1	STRING	Rótulo personalizado 1
custom_labels.label_2	STRING	Rótulo personalizado 2
custom_labels.label_3	STRING	Rótulo personalizado 3
custom_labels.label_4	STRING	Rótulo personalizado 4
gender	STRING	Gênero a que o item é voltado
gtin	STRING	Número do item no mercado global (GTIN, na sigla em inglês)
item_group_id	STRING	Identificador partilhado por todas as variantes do mesmo produto
material	STRING	Material de que o item é feito
mpn	STRING	Número de série do fabricante (MPN, na sigla em inglês) do item
pattern	STRING	Estampa do item, por exemplo, bolinhas
price	RECORD	Preço do item
price.value	NUMERIC	O preço do item
price.currency	STRING	A moeda do preço
sale_price	RECORD	Preço de venda do item anunciado
sale_price.value	NUMERIC	O preço de venda do item
sale_price.currency	STRING	A moeda do preço de venda
sale_price_effective_start_date	TIMESTAMP	Data e hora de início das vendas do item
sale_price_effective_end_date	TIMESTAMP	Data e hora de término das vendas do item
google_product_category	INTEGER	O código da categoria Google do produto do item
google_product_category_ids	INTEGER, REPEATED	O caminho completo das categorias Google do produto para o item, armazenado como um conjunto de códigos
google_product_category_path	STRING	Uma versão legível por humanos do caminho completo
product_type	STRING	Categoria do item informada pelo comerciante
additional_product_types	STRING, REPEATED	Categorias extras do item
destinations	RECORD, REPEATED	Os destinos pretendidos do produto
destinations.name	STRING	O nome do destino. atualmente, somente "Shopping" é compatível
destinations.status*	STRING	O status de aprovação do destino. Os valores possíveis são "aprovado", "reprovado" e "pendente"
destinations.name	STRING	O nome do destino. No momento, apenas "Shopping" é compatível.
destinations.approved_countries	STRING, REPEATED	Lista de códigos de território CLDR em que a oferta foi aprovada.
destinations.pending_countries	STRING, REPEATED	Lista de códigos de território CLDR em que a oferta está pendente.
destinations.disapproved_countries	STRING, REPEATED	Lista de códigos de território CLDR em que a oferta foi reprovada.
issues	RECORD, REPEATED	A lista de problemas do item associada ao produto
issues.code	STRING	O código de erro do problema
issues.servability	STRING	Como esse problema afeta a veiculação da oferta
issues.resolution	STRING	Se o problema pode ser resolvido pelo comerciante
issues.attribute_name	STRING	O nome do atributo, se o problema for causado por um único atributo
issues.destination	STRING	O destino a que o problema se aplica
issues.short_description	STRING	Descrição resumida do problema em inglês
issues.detailed_description	STRING	Descrição detalhada do problema em inglês
issues.documentation	STRING	URL de uma página da web para ajudar a resolver esse problema
issues.applicable_countries	STRING, REPEATED	Lista de códigos de território CLDR em que o problema se aplica.