Como formatar um CSV de importação em massa

Use o método import para criar um conjunto de produtos e produtos com imagens de referência, ao mesmo tempo, usando um arquivo CSV. Nesta página, descrevemos como formatar o arquivo CSV.

Como criar as imagens de referência

Imagens de referência são imagens com diversas visualizações dos produtos. As seguintes recomendações se aplicam:

  • Verifique se o arquivo não excede o tamanho máximo de 20 MB.
  • Pense nos pontos de vista que destacam logicamente o produto e contêm informações visuais relevantes.
  • Crie imagens de referência que complementam os pontos de vista ausentes. Por exemplo, se você só tiver imagens do tênis direito de um par, forneça versões espelhadas desses arquivos como o tênis esquerdo.
  • Faça upload da imagem de maior resolução disponível.
  • Mostre o produto sobre um fundo branco.
  • Converta PNGs com planos de fundo transparentes em um plano de fundo sólido.

As imagens precisam ser armazenadas em um bucket do Cloud Storage. Se você estiver autenticando a chamada de criação de imagem com uma chave de API, o bucket precisará ser público. Caso você esteja autenticando com uma conta de serviço, ela precisará ter acesso de leitura ao bucket.

Diretrizes de formatação de CSV

Para usar o método import, o arquivo CSV e as imagens a que ele se refere precisam estar em um bucket do Cloud Storage. Os arquivos CSV são limitados a um máximo de 20.000 linhas. Cada linha é limitada a um máximo de 2.048 caracteres. Para importar mais imagens, divida-as em vários arquivos CSV.

O arquivo CSV precisa conter uma imagem por linha e incluir as colunas a seguir:

  1. image-uri: o URI do Cloud Storage da imagem de referência.
  2. image-id: opcional. Um valor exclusivo, se você fornecê-lo. Caso contrário, o sistema atribuirá um valor exclusivo.
  3. product-set-id: um identificador exclusivo para o conjunto de produtos ao qual importar as imagens.

  4. product-id: um ID definido pelo usuário para o produto identificado pela imagem de referência. Um product-id pode ser associado a várias imagens de referência.

  5. product-category: os valores permitidos são homegoods-v2, apparel-v2, toys-v2, packagedgoods-v1 e general-v1 *. A categoria do produto identificado pela imagem de referência. Inferido pelo sistema se não for especificado na solicitação de criação. Os valores permitidos também são listados na documentação de referência de productCategory.

  6. product-display-name: opcional. Se você não fornecer um nome para o produto, displayName será definido como " ". É possível atualizar esse valor mais tarde.

  7. labels: opcional. Uma string (com aspas) de pares de chave-valor que descrevem os produtos na imagem de referência. Por exemplo:

    • "category=shoes"

    • "color=black,style=formal"

      A Pesquisa de produtos da API Vision também permite que você forneça vários valores para uma única chave. Por exemplo:

    • "category=shoes,category=heels"

    • "color=black,style=formal,style=mens"

  8. bounding-poly: opcional. Especifica a área de interesse na imagem de referência. Se uma caixa delimitadora não for especificada, ocorrerá o seguinte:

    1. Caixas delimitadoras para a imagem serão inferidas pela API Vision. Várias regiões em uma única imagem poderão ser indexadas se vários produtos forem detectados pela API.
    2. A linha precisará terminar com uma vírgula.

    Consulte o exemplo abaixo para ver um produto sem um polígono delimitador especificado.

    Se você incluir uma caixa delimitadora, a coluna boundingPoly precisará conter um número par de números separados por vírgula, com o formato p1_x,p1_y,p2_x,p2_y,...,pn_x,pn_y. Uma linha de exemplo tem esta aparência: 0.1,0.1,0.9,0.1,0.9,0.9,0.1,0.9.

    Para definir uma caixa delimitadora com os valores reais de pixels da sua imagem, use números inteiros não negativos. Assim, é possível expressar caixas delimitadoras em imagens de 1.000 x 1.000 pixels da seguinte maneira:

    gs://example-reference-images/10001-001/10001-001_A.jpg,img001,sample-set-summer,sample-product-123,tan summer bag,apparel-v2,"style=womens,color=tan",100,150,450,150,450,550,100,550
gs://example-reference-images/10001-001/10001-001_A.jpg,img001,sample-set-summer,sample-product-456,blue summer bag,apparel-v2,"style=womens,color=blue",670,790,980,790,980,920,670,920
gs://example-reference-images/10002-002/10002-002_B.jpg,img002,sample-set-summer,sample-product-123,apparel-v2,,,

    A Pesquisa de produtos da API Vision também permite usar valores normalizados para caixas delimitadoras. Defina uma caixa delimitadora usando valores normalizados com valores flutuantes em [0, 1].

    Usando valores normalizados, as linhas da imagem de referência acima também podem ser expressas como:

    gs://example-reference-images/10001-001/10001-001_A.jpg,img001,sample-set-summer,sample-product-123,tan summer bag,apparel-v2,"style=womens,color=tan",0.10,0.15,0.45,0.15,0.45,0.55,0.10,0.55
gs://example-reference-images/10001-001/10001-001_A.jpg,img001,sample-set-summer,sample-product-456,blue summer bag,apparel-v2,"style=womens,color=blue",0.67,0.79,0.98,0.79,0.98,0.92,0.67,0.92
gs://example-reference-images/10002-002/10002-002_B.jpg,img002,sample-set-summer,sample-product-123,apparel-v2,,,