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:- Canal ("on-line" ou "local")
- Idioma do conteúdo (usando a designação de duas letras, por exemplo,
en
oufr
) - Rótulo do feed (pode ser o código de duas letras do país de destino do feed, por exemplo,
US
ouFR
) - 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. |