Method: projects.locations.productSets.import

API asíncrona que importa una lista de imágenes de referencia a conjuntos de productos especificados a partir de una lista de información de imágenes.

La API google.longrunning.Operation se puede usar para monitorizar el progreso y los resultados de la solicitud. Operation.metadata contiene BatchOperationMetadata. (progreso) Operation.response contiene ImportProductSetsResponse. (resultados)

La fuente de entrada de este método es un archivo CSV en Google Cloud Storage. Para ver el formato del archivo CSV, consulta ImportProductSetsGcsSource.csv_file_uri.

Solicitud HTTP

POST https://vision.googleapis.com/v1p4beta1/{parent=projects/*/locations/*}/productSets:import

La URL utiliza la sintaxis de transcodificación a gRPC.

Parámetros de ruta

Parámetros
parent

string

Proyecto en el que se deben importar los ProductSets.

El formato es projects/PROJECT_ID/locations/LOC_ID.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos que presentan la siguiente estructura:

Representación JSON 
{
  "inputConfig": {
    object (ImportProductSetsInputConfig)
  }
}
Campos
inputConfig

object (ImportProductSetsInputConfig)

El contenido de entrada de la lista de solicitudes.

Cuerpo de la respuesta

Si la solicitud se hace correctamente, en el cuerpo de la respuesta se incluye una instancia de Operation.

Permisos de autorización

Debes disponer de uno de los siguientes permisos de OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Para obtener más información, consulta el artículo Descripción general de la autenticación.

ImportProductSetsInputConfig

El contenido de entrada del método productSets.import.

Representación JSON 
{
  "gcsSource": {
    object (ImportProductSetsGcsSource)
  }
}
Campos
gcsSource

object (ImportProductSetsGcsSource)

Ubicación de Google Cloud Storage de un archivo CSV que conserva una lista de ImportProductSetRequests en cada línea.

ImportProductSetsGcsSource

Ubicación de Google Cloud Storage de un archivo CSV que conserva una lista de ImportProductSetRequests en cada línea.

Representación JSON 
{
  "csvFileUri": string
}
Campos
csvFileUri

string

El URI de Google Cloud Storage del archivo CSV de entrada.

El URI debe empezar por gs://.

El formato del archivo CSV de entrada debe ser una imagen por línea. Cada línea tiene 8 columnas.

  1. image-uri
  2. image-id
  3. product-set-id
  4. product-id
  5. product-category
  6. product-display-name
  7. etiquetas
  8. bounding-poly

Las columnas image-uri, product-set-id, product-id y product-category son obligatorias. Todas las demás columnas son opcionales.

Si no existe el ProductSet o el Product especificado por los valores product-set-id y product-id, el sistema creará un ProductSet o un Product para la imagen. En este caso, la columna product-display-name hace referencia a displayName, la columna product-category hace referencia a productCategory y la columna labels hace referencia a productLabels.

La columna image-id es opcional, pero debe ser única si se proporciona. Si está vacío, el sistema asignará automáticamente un ID único a la imagen.

La columna product-display-name es opcional. Si está vacío, el sistema asigna un espacio (" ") al campo displayName del producto. Puede actualizar el campo displayName más adelante mediante la API.

Si ya existe un Product con el product-id especificado, el sistema ignora las columnas product-display-name, product-category y labels.

La columna labels (opcional) es una línea que contiene una lista de pares clave-valor separados por comas con el siguiente formato:

"key_1=value_1,key_2=value_2,...,key_n=value_n"

La columna bounding-poly (opcional) identifica una región de interés de la imagen de la misma forma que referenceImages.create. Si no especifica la columna bounding-poly, el sistema intentará detectar las regiones de interés automáticamente.

Se permite una columna bounding-poly como máximo por línea. Si la imagen contiene varias regiones de interés, añada una línea al archivo CSV que incluya la misma información del producto y los valores bounding-poly de cada región de interés.

La columna bounding-poly 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". Usa números enteros no negativos para los polígonos envolventes absolutos y valores flotantes en [0, 1] para los polígonos envolventes normalizados.

El sistema cambiará el tamaño de la imagen si la resolución es demasiado grande para procesarla (más de 20 MP).