Formatear un archivo CSV de importación masiva

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

Crea tus imágenes de referencia

Las imágenes de referencia son imágenes que contienen varias vistas de los productos. Ten en cuenta las siguientes recomendaciones:

  • Asegúrate de que el tamaño del archivo no supere el tamaño máximo (20 MB).
  • Considera los puntos de vista que destacan el producto de forma lógica y que contienen 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 duplicadas de esos archivos para el zapato izquierdo.
  • Sube la imagen disponible que tenga la resolución más alta.
  • Muestra el producto sobre un fondo blanco.
  • Convierte el fondo transparente de los PNG en un fondo sólido.

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

Lineamientos del formato CSV

Para usar el método import, el archivo CSV y las imágenes a las que se orienta deben estar en un bucket de Google Cloud Storage. Los archivos CSV se limitan a un máximo de 20,000 líneas, cada una con un límite de 2,048 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 suministras. De lo contrario, el sistema asignará un valor único
  3. product-set-id: Un identificador único para el conjunto de productos en el que se importarán las imágenes

  4. product-id: Un ID definido por el usuario para el producto que la imagen de referencia identifica. Un product-id se puede asociar con 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 infiere si no se especifica en la solicitud de creación. Los valores permitidos también se enumeran en la documentación de referencia de productCategory.

  6. product-display-name: Opcional. Si no proporcionas un nombre para el producto, displayName se configurará como “ ”. Puedes actualizar este valor más tarde.

  7. labels: Opcional. Una string (entre comillas) de pares clave-valor que describe los productos en la imagen de referencia. Por ejemplo:

    • "category=shoes"

    • "color=black,style=formal"

      API de Vision para Product Search 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 en la imagen de referencia. Si no se especifica un cuadro de límite, sucede lo siguiente:

    1. La API de Vision infiere los cuadros de límite de la imagen, es posible que se indexen varias regiones en una sola imagen si la API detecta varios productos.
    2. La línea debe terminar con una coma.

    Consulta el ejemplo a continuación de un producto sin un polígono de límite especificado.

    Si incluyes un cuadro de límite, la columna boundingPoly debe contener una cantidad 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 se ve de la siguiente manera: 0.1,0.1,0.9,0.1,0.9,0.9,0.1,0.9.

    Para definir un cuadro de límite con los valores de píxeles reales de tu imagen, usa números enteros que no sean negativos. Entonces podrías expresar los cuadros de límite en imágenes de 1,000 x 1,000 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,,,

    API de Vision para Product Search también te permite usar valores normalizados para los cuadros de límite. Define un cuadro de límite con valores normalizados con valores flotantes en [0, 1].

    Con valores normalizados, las filas de la imagen de referencia anterior también podrían expresarse 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,,,