Aplicar formato a un CSV de importación en bloque

Puede usar el método import para crear un conjunto de productos y productos con imágenes de referencia al mismo tiempo mediante un archivo CSV. En esta página se describe cómo dar formato al archivo CSV.

Crear imágenes de referencia

Las imágenes de referencia son imágenes que contienen varias vistas de sus productos. Deben aplicarse las siguientes recomendaciones:

  • Asegúrate de que el tamaño del archivo no supere el tamaño máximo (20 MB).
  • Ten en cuenta los puntos de vista que destaquen el producto de forma lógica y contengan información visual relevante.
  • Crea imágenes de referencia que complementen los puntos de vista que falten. Por ejemplo, si solo tienes imágenes del zapato derecho de un par, proporciona versiones reflejadas de esos archivos como zapato izquierdo.
  • Suba la imagen con la mayor resolución posible.
  • Muestra el producto sobre un fondo blanco.
  • Convierte archivos PNG con fondos transparentes en fondos sólidos.

Las imágenes deben almacenarse en un segmento de Cloud Storage. Si autenticas la llamada de creación de imágenes con una clave de API, el contenedor debe ser público. Si te autenticas con una cuenta de servicio, esta debe tener acceso de lectura al segmento.

Directrices de formato CSV

Para usar el método import, tanto el archivo CSV como las imágenes a las que apunta deben estar en un segmento de Cloud Storage. Los archivos CSV tienen un límite de 20.000 líneas y cada línea puede tener un máximo de 2048 caracteres. Para importar más imágenes, divídelas en varios archivos CSV.

El archivo CSV debe contener una imagen por línea y las siguientes columnas:

  1. image-uri: el URI de Cloud Storage de la imagen de referencia.
  2. image-id: Opcional. Un valor único si lo proporciona. De lo contrario, el sistema asignará un valor único.
  3. product-set-id: identificador único del conjunto de productos al que se importarán las imágenes.

  4. product-id: ID definido por el usuario del producto identificado por la imagen de referencia. Un product-id se puede asociar a varias imágenes de referencia.

  5. product-category: los valores permitidos son homegoods-v2, apparel-v2, toys-v2, packagedgoods-v1 y general-v1. *; la categoría del producto identificado por la imagen de referencia. El sistema lo deduce si no se especifica en la solicitud de creación. Los valores permitidos también se indican en la documentación de referencia de productCategory.

  6. product-display-name: Opcional. Si no proporciona un nombre para el producto, el valor de displayName será " ". Puede actualizar este valor más adelante.

  7. labels: Opcional. Cadena (entre comillas) de pares clave-valor que describen los productos de la imagen de referencia. Por ejemplo:

    • "category=shoes"

    • "color=black,style=formal"

      Product Search de la API Vision también te permite proporcionar varios valores para una sola clave. Por ejemplo:

    • "category=shoes,category=heels"

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

  8. bounding-poly: Opcional. Especifica el área de interés de la imagen de referencia. Si no se especifica ningún cuadro delimitador:

    1. La API Vision infiere los cuadros delimitadores de la imagen. Se pueden indexar varias regiones de una sola imagen si la API detecta varios productos.
    2. La línea debe terminar con una coma.

    En el ejemplo siguiente se muestra un producto sin polígono envolvente especificado.

    Si incluye un cuadro delimitador, la columna boundingPoly debe contener un número par de números separados por comas con el formato p1_x,p1_y,p2_x,p2_y,...,pn_x,pn_y. Una línea de ejemplo tiene este aspecto: 0.1,0.1,0.9,0.1,0.9,0.9,0.1,0.9.

    Para definir un cuadro delimitador con los valores de píxeles reales de la imagen, usa números enteros no negativos. Por lo tanto, podrías expresar los cuadros delimitadores en imágenes de 1000x1000 píxeles de la siguiente manera:

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

    Product Search de la API de Vision también te permite usar valores normalizados para los cuadros delimitadores. Define un cuadro delimitador con valores normalizados con valores de tipo float en [0, 1].

    Si se usan valores normalizados, las filas de la imagen de referencia anterior también se podrían expresar de la siguiente manera:

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