REST Resource: projects.locations.products

Recurso: produto

Um produto contém ReferenceImages.

Representação JSON
{
  "name": string,
  "displayName": string,
  "description": string,
  "productCategory": string,
  "productLabels": [
    {
      object (KeyValue)
    }
  ]
}
Campos
name

string

O nome do recurso do produto.

O formato é: projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID.

Este campo é ignorado quando cria um produto.

displayName

string

O nome fornecido pelo utilizador para este produto. Não pode estar vazio. Tem de ter, no máximo, 4096 carateres.

description

string

Metadados fornecidos pelo utilizador a serem armazenados com este produto. Tem de ter, no máximo, 4096 carateres.

productCategory

string

Imutável. A categoria do produto identificado pela imagem de referência. Deve ser "homegoods-v2", "apparel-v2" ou "toys-v2". As categorias antigas "homegoods", "apparel" e "toys" ainda são suportadas, mas não devem ser usadas para novos produtos.

productLabels[]

object (KeyValue)

Pares de chave-valor que podem ser anexados a um produto. No momento da consulta, as restrições podem ser especificadas com base nos productLabels.

Tenha em atenção que os valores inteiros podem ser fornecidos como strings, por exemplo, "1199". Apenas as strings com valores inteiros podem corresponder a uma restrição baseada em intervalo, que vai ser suportada em breve.

Podem ser atribuídos vários valores à mesma chave. Um produto pode ter até 500 productLabels.

Tenha em atenção que o número total de productLabels distintos em todos os produtos num ProductSet não pode exceder 1 milhão. Caso contrário, o pipeline de pesquisa de produtos recusa-se a funcionar para esse ProductSet.

KeyValue

Uma etiqueta de produto representada como um par de chave-valor.

Representação JSON
{
  "key": string,
  "value": string
}
Campos
key

string

A chave da etiqueta anexada ao produto. Não pode estar vazio e não pode exceder 128 bytes.

value

string

O valor da etiqueta anexada ao produto. Não pode estar vazio e não pode exceder 128 bytes.

Métodos

create

Cria e devolve um novo recurso de produto.

delete

Elimina permanentemente um produto e as respetivas imagens de referência.

get

Obtém informações associadas a um produto.

list

Apresenta os produtos numa ordem não especificada.

patch

Faz alterações a um recurso Product.

purge

API assíncrona para eliminar todos os produtos num ProductSet ou todos os produtos que não estão em nenhum ProductSet.