IDs de produto

Gostaríamos de apresentar a versão Beta da API Merchant. Esta é a nova versão da API Content e o futuro.

Estes são 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 ID representa um produto individual.

offerId é exclusivo do 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 REST

O ID REST é o identificador exclusivo de um produto atribuído pelo Google.

O ID REST é o productId para chamadas da API REST.

Os IDs REST são agregados no formato online:en:label:1111111111. Ele 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 para o país de destino do feed, por exemplo, US ou FR)
4. Código da oferta

Junte esses dados como channel:contentLanguage:feedLabel:offerId, por exemplo, online:en:US:1111111111.

ID do vendedor externo (mercados)

Os marketplaces precisam atribuir um external_seller_id às ofertas enviadas a 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
• Somente caracteres alfanuméricos ASCII e sublinhado (_), hífen (-), ponto (.) e til (~).

Ele não é o mesmo que o 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	ID atribuído a um produto por um comerciante.	1111111111	Tipo de dados de string, identificador exclusivo da oferta de um produto.
ID REST	É um ID atribuído a um produto pelo Google. Use o formato channel:contentLanguage:feedLabel:offerId.	online:en:label:1111111111	ID completo, incluindo offerId
productId	Usado para se referir ao ID REST em chamadas de API.	online:en:label:1111111111	Esse é o ID REST de um produto.
id	Mesmo valor que o ID REST e productId.	online:en:label:1111111111	Usado no corpo JSON de um produto para se referir ao productId dele.
external_seller_id	Um ID de vendedor escolhido pelo Marketplace.	example-Seller1	Obrigatório para contas de vários vendedores. Precisa ter de 1 a 50 caracteres. Diferencia maiúsculas de minúsculas. Dígitos e caracteres especiais _, -, . e ~ são aceitos.