Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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:
Canal ("on-line" ou "local")
Idioma do conteúdo (usando a designação de duas letras, por exemplo, en ou fr)
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)
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 (~).
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.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2024-07-03 UTC."],[[["The Merchant API is the new version of the Content API for Shopping and represents the future of product data integration with Google."],["The beta version of the Merchant API is now available for developers to explore and help shape its future development."],["Developers can learn more about the benefits and features of the Merchant API, including how it can enhance integrations, in the official announcement blog post."],["Products in the Merchant API are identified using various IDs, such as `offerId`, REST ID, `productId`, and `external_seller_id`, each with specific characteristics and usage contexts."],["A comprehensive table provides detailed explanations and examples of different product ID attributes, outlining their purpose and format."]]],["The beta version of the Merchant API, the new Content API for Shopping, is introduced. Merchants assign an `offerId` to products. Google assigns a unique REST ID in the format `channel:contentLanguage:feedLabel:offerId`; this is also the `productId` and `id` in API calls. Marketplaces assign `external_seller_id` to offers for multi-seller accounts, it has specific format requirements. The Merchant API offers integration improvements; details on this and providing feedback are available via a linked article.\n"]]
