IDs de produto

Veja os diferentes tipos de IDs de produto na API Content for Shopping:

Código da oferta
Uma offerId é uma string atribuída a um produto por um comerciante. Esse código representa um produto individual.
O offerId é exclusivo para o conjunto de ofertas no banco de dados do Merchant Center e geralmente é um número sequencial numérico.
offerId pode ser um número de SKU interno que um comerciante atribui ao produto.
ID da REST
O ID REST é o identificador exclusivo de um produto atribuído pelo Google.
O ID REST é o productId das chamadas da API REST.

Os IDs REST são agregados com o formato online:en:label:1111111111. O ID REST consiste nas quatro partes a seguir, separadas por dois pontos:

  1. Canal ("on-line" ou "local")
  2. Idioma do conteúdo (usando a designação de duas letras, por exemplo, en ou fr)
  3. Rótulo do feed (pode ser o código de duas letras do país de destino do feed, por exemplo, US ou FR)
  4. Código da oferta

Você vai unir isso como channel:contentLanguage:feedLabel:offerId, por exemplo, online:en:US:1111111111.

ID externo do vendedor (marketplaces)

Os marketplaces precisam atribuir um external_seller_id às ofertas enviadas para uma conta de vários vendedores. Esse campo representa um vendedor individual.

Os valores external_seller_id diferenciam maiúsculas de minúsculas e precisam atender aos seguintes critérios:

  • De 1 a 50 caracteres de comprimento
  • Somente caracteres ASCII alfanuméricos e sublinhado (_), hífen (-), ponto (.) e til (~)

Isso não é igual ao campo seller_id interno.

A tabela a seguir resume alguns dos IDs que podem ser associados a um produto:

Atributo Descrição Exemplo Observações
offerId Um código atribuído a um produto por um comerciante. 1111111111 Tipo de dados de string, identificador exclusivo para a oferta de um produto.
ID da REST Um código atribuído a um produto pelo Google. No formato channel:contentLanguage:feedLabel:offerId. online:en:label:1111111111 ID completo, incluindo offerId.
productId Usado para fazer referência ao ID REST nas chamadas de API. online:en:label:1111111111 Esse é o código REST de um produto.
id Mesmo valor que o ID REST e productId. online:en:label:1111111111 Usado dentro do corpo JSON de um produto para se referir ao productId dele.
external_seller_id Um ID do vendedor escolhido pelo Marketplace. example-Seller1 Obrigatório para contas de vários vendedores. Precisa ter entre 1 e 50 caracteres. Diferencia maiúsculas de minúsculas. Os dígitos e os caracteres especiais _, -, . e ~ são aceitos.
Anterior
Visão geral
Avançar
Chamadas de API