Formatar um CSV de importação em massa

Pode usar o método import para criar um conjunto de produtos e produtos com imagens de referência ao mesmo tempo usando um ficheiro CSV. Esta página descreve como formatar o ficheiro CSV.

Criar as suas imagens de referência

As imagens de referência são imagens que contêm várias vistas dos seus produtos. Aplicam-se as seguintes recomendações:

  • Certifique-se de que o tamanho do ficheiro não excede o tamanho máximo (20 MB).
  • Considere pontos de vista que realcem logicamente o produto e contenham informações visuais relevantes.
  • Crie imagens de referência que complementem os pontos de vista em falta. Por exemplo, se tiver apenas imagens do sapato direito de um par, forneça versões espelhadas desses ficheiros como o sapato esquerdo.
  • Carregue a imagem com a resolução mais alta disponível.
  • Mostre o produto num fundo branco.
  • Converter PNGs com fundos transparentes num fundo sólido.

As imagens têm de ser armazenadas num contentor do Cloud Storage. Se estiver a autenticar a chamada de criação de imagens com uma chave da API, o contentor tem de ser público. Se estiver a fazer a autenticação com uma conta de serviço, essa conta de serviço tem de ter acesso de leitura no contentor.

Diretrizes de formatação de CSV

Para usar o método import, tanto o ficheiro CSV como as imagens a que se refere têm de estar num contentor do Cloud Storage. Os ficheiros CSV estão limitados a um máximo de 20 000 linhas. Cada linha está limitada a um máximo de 2048 carateres. Para importar mais imagens, divida-as em vários ficheiros CSV.

O ficheiro CSV tem de conter uma imagem por linha e as seguintes colunas:

  1. image-uri: o URI do Cloud Storage da imagem de referência.
  2. image-id: Opcional. Um valor único, se o fornecer. Caso contrário, o sistema atribui um valor único.
  3. product-set-id: um identificador exclusivo do conjunto de produtos para o qual importar as imagens.

  4. product-id: um ID definido pelo utilizador 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 no pedido de criação. Os valores permitidos também estão listados na productCategory documentação de referência.

  6. product-display-name: Opcional. Se não fornecer um nome para o produto, o valor displayName é definido como " ". Pode atualizar este 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 API Vision Product Search também lhe permite fornecer 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 não for especificada uma caixa limitadora:

    1. As caixas delimitadoras da imagem são inferidas pela API Vision. Podem ser indexadas várias regiões numa única imagem se a API detetar vários produtos.
    2. A linha tem de terminar com uma vírgula.

    Veja o exemplo abaixo de um produto sem um polígono de delimitação especificado.

    Se incluir uma caixa delimitadora, a coluna boundingPoly deve conter um número par de números separados por vírgulas, com o formato p1_x,p1_y,p2_x,p2_y,...,pn_x,pn_y. Uma linha de exemplo tem o seguinte aspeto: 0.1,0.1,0.9,0.1,0.9,0.9,0.1,0.9.

    Para definir uma caixa delimitadora com os valores de píxeis reais da sua imagem, use números inteiros não negativos. Assim, pode expressar caixas delimitadoras em imagens de 1000 píxeis por 1000 píxeis da seguinte forma:

    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 API Vision Product Search também lhe permite usar valores normalizados para caixas delimitadoras. Defina uma caixa delimitadora com valores normalizados com valores float em [0, 1].

    Usando valores normalizados, as linhas de imagens de referência acima também podem ser expressas da seguinte forma:

    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,,,