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:
image-uri
: El URI de Cloud Storage de la imagen de referencia.image-id
: Opcional. Un valor único, si lo suministras. De lo contrario, el sistema asignará un valor únicoproduct-set-id
: Un identificador único para el conjunto de productos en el que se importarán las imágenesproduct-id
: Un ID definido por el usuario para el producto que la imagen de referencia identifica. Unproduct-id
se puede asociar con varias imágenes de referenciaproduct-category
: Los valores permitidos sonhomegoods-v2
,apparel-v2
,toys-v2
,packagedgoods-v1
ygeneral-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 deproductCategory
.product-display-name
: Opcional. Si no proporcionas un nombre para el producto,displayName
se configurará como “ ”. Puedes actualizar este valor más tarde.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"
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:- 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.
- 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 formatop1_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,,,