Prepare sua conta do Merchant Center

Você precisa ter uma conta do Merchant Center em situação regular e produtos aprovados para listagens sem custo financeiro nela. Para começar, consulte estes artigos da Central de Ajuda:

Depois de configurar o Merchant Center com produtos, você precisa atender aos requisitos desta seção antes de criar a integração da API.

1. Configurações do Merchant Center

Verifique se as seguintes configurações estão definidas na sua conta do Google Merchant Center:

1.1. Política de devolução

Você precisa definir suas políticas de devolução no Merchant Center, já que é um requisito do comerciante de registro e será referenciado na tela de finalização da compra. As políticas configuradas são aplicadas globalmente à sua conta, mas é possível usar o atributo de feed return_policy_label para restringir uma política de devolução específica a um subconjunto de produtos.

Se a conta do Merchant Center for uma conta avançada, as políticas de devolução precisarão ser configuradas em cada subconta individual.

É necessário incluir o custo e a velocidade (período) da devolução, além de um link para a política completa. Leia mais sobre como configurar devoluções.

1.2. Informações de suporte ao cliente

Você precisa definir as informações de suporte ao cliente no Merchant Center. Ele será usado para gerar o link "Entre em contato com o comerciante" na página de confirmação do pedido. Leia mais sobre como definir informações de suporte ao cliente aqui.

2. Dados do produto

É necessário atualizar o feed de produtos para sinalizar a qualificação e fornecer dados de conformidade. Essas informações são necessárias para ativar o pagamento pelo UCP com o Google, já que permitem que os agentes determinem a qualificação do produto, calculem os custos totais precisos e mostrem os avisos legais obrigatórios ao usuário.

2.1. Qualificação para o pagamento agêntico

Isso ativa a experiência de finalização de compra no Google para um produto.

Isso é fornecido usando um atributo de produto native_commerce que contém um único booleano. Se for definido como "false" ou estiver faltando, o produto não vai estar qualificado para finalização da compra.

2.2. Avisos de produtos

Isso é obrigatório para itens com requisitos de aviso regulamentar (por exemplo, Proposição 65 da Califórnia). Você é responsável pela conformidade com todas as leis aplicáveis, incluindo requisitos de advertência do produto. Esses avisos são mostrados em destaque na tela de finalização da compra quando você os fornece.

Forneça o grupo de atributos consumer_notice com dois subatributos:

  • consumer_notice_type: precisa ser legal_disclaimer, safety_warning ou prop_65.
  • consumer_notice_message: string (máximo de 1.000 caracteres). As tags HTML <b>, <br> e <i> são aceitas.

2.3. Identificador de produto

O id no seu feed de produtos precisa corresponder ao ID do produto esperado pela API Checkout. Se eles corresponderem, nenhuma ação será necessária. Caso contrário, use o atributo personalizado merchant_item_id para mapeá-los.

2.4. Como adicionar atributos aos produtos

Os exemplos a seguir descrevem diferentes opções para fornecer o produto ao Merchant Center.

2.4.1. Feeds

Recomendamos que você crie uma fonte de dados complementar (instruções aqui). Você pode adicionar isso ao seu feed principal, mas tenha cuidado, porque uma formatação incorreta pode afetar a ingestão regular de produtos.

Observação sobre a sintaxe:verifique se strings complexas (como a mensagem da Proposta 65) não contêm caracteres que quebram o formato do arquivo (como vírgulas extras em um CSV), a menos que estejam devidamente escapados.

Formato do arquivo de texto:

ID native_commerce consumer_notice
11111 TRUE prop_65:This product can expose you...
22222 TRUE
33333 FALSO

Formato XML:

<item>
  <g:id>11111</g:id>
  <g:native_commerce>TRUE</g:native_commerce>
  <g:consumer_notice>
    <g:consumer_notice_type>prop_65</g:consumer_notice_type>
    <g:consumer_notice_message>
      This product can expose you to chemicals...
    </g:consumer_notice_message>
  </g:consumer_notice>
</item>
<item>
  <g:id>22222</g:id>
  <g:native_commerce>TRUE</g:native_commerce>
</item>
<item>
  <g:id>33333</g:id>
  <g:native_commerce>FALSE</g:native_commerce>
</item>

2.4.2. API Content

Forneça os atributos como atributos personalizados. Eles precisam ser incluídos em um products.insert que contenha o produto completo, porque products.update não oferece suporte à atualização de customAttributes.

Exemplo:

"customAttributes": [
  {
    "name": "native commerce",
    "groupValues": [
      {
        "name": "checkout eligibility",
        "value": "true"
      }
    ]
  },
  {
    "name": "consumer notice",
    "groupValues": [
      {
        "name": "notice type",
        "value": "prop_65"
      },
      {
        "name": "notice message",
        "value": "This product can expose you to chemicals..."
      }
    ]
  },
  {
    "name": "merchant item id",
    "value": "some_checkout_item_id_1"
  }
]

2.4.2. API Merchant

Forneça os atributos como atributos personalizados. Você pode adicioná-los ao seu accounts.productInputs.insert ou atualizar diretamente usando accounts.productInputs.patch.

Exemplo para insert:

"customAttributes": [
  {
    "name": "native commerce",
    "groupValues": [
      {
        "name": "checkout eligibility",
        "value": "true"
      }
    ]
  },
  {
    "name": "consumer notice",
    "groupValues": [
      {
        "name": "notice type",
        "value": "prop_65"
      },
      {
        "name": "notice message",
        "value": "This product can expose you to chemicals..."
      }
    ]
  },
  {
    "name": "merchant item id",
    "value": "some_checkout_item_id_1"
  }
]

Exemplo de update:

Tipo Nome Valor
Parâmetros de caminho productInput.name accounts/{account}/productInputs/en~US~11111
Parâmetros de consulta updateMask customAttributes.native%20commerce,customAttributes.consumer%20notice,customAttributes.product%20fee,customAttributes.merchant%20item%20id
dataSource dataSources/{datasource} 
{
  "offerId": "11111",
  "contentLanguage": "en",
  "feedLabel": "US",
    "customAttributes": [
    {
      "name": "native commerce",
      "groupValues": [
        {
          "name": "checkout eligibility",
          "value": "true"
        }
      ]
    },
    {
      "name": "consumer notice",
      "groupValues": [
        {
          "name": "notice type",
          "value": "prop_65"
        },
        {
          "name": "notice message",
          "value": "This product can expose you to chemicals..."
        }
      ]
    },
    {
      "name": "product fee",
      "groupValues": [
        {
          "name": "product fee type",
          "value": "US_AZ_TIRE_FEE"
        },
        {
          "name": "product fee amount",
          "value": "2.75 USD"
        }
      ]
    },
    {
      "name": "merchant item id",
      "value": "some_checkout_item_id_1"
    }
  ]
}

3. Restrições de produtos

As seguintes categorias de produtos não estão qualificadas para a finalização de compra. Verifique se esses itens têm native_commerce vazio ou definido como false.

Produtos financeiros e modelos de faturamento recorrente

  • Assinaturas: produtos que exigem ciclos de faturamento recorrentes.
  • Parcelas: transações que exigem planos de pagamento ou financiamento obrigatórios para o comerciante.

Produtos personalizados e opções de atendimento

  • Produtos personalizados: itens que exigem decisões de design personalizadas (por exemplo, gravações, monogramas).
  • Itens não novos ou de venda final: produtos recondicionados, usados e marcados como "Venda final" (sem devoluções).
  • Itens em pré-venda: produtos com datas de lançamento futuras e atendimento adiado.
  • Serviços agrupados: itens que exigem contratos adicionais, como garantias, instalação ou configuração.
  • Frete especial: itens que exigem taxas de entrega não padrão (por exemplo, frete, entrega premium).
  • Presentes: transações que exigem logística de fatura dividida ou preços ocultos para destinatários.
  • Ativação na loja: produtos que precisam ser ativados fisicamente em um local de varejo.

Restrições de política e segurança

  • Restrição de idade: itens que exigem confirmação de identidade (por exemplo, bebidas alcoólicas, tabaco).
  • Conteúdo proibido: armas, conteúdo adulto, saúde/produtos farmacêuticos, falsificações ou qualquer outra categoria bloqueada pela política padrão do Google Shopping.

Produtos e serviços digitais

  • Serviços: aulas, aulas on-line e pacotes de viagem (a menos que integrados usando trilhos de viagem específicos).
  • Aluguel: de filmes, equipamentos ou leasing.
  • Itens virtuais: moedas do jogo, itens de MMORPG ou skins.
  • Dependências de software: produtos que exigem que o usuário instale um software específico antes de concluir a compra.