Method: projects.locations.productSets.import

• Solicitud HTTP
• Parámetros de ruta de acceso
• Cuerpo de la solicitud
  • Representación JSON
• Cuerpo de la respuesta
• Alcances de autorización
• ImportProductSetsInputConfig
  • Representación JSON
• ImportProductSetsGcsSource
  • Representación JSON

API asíncrona que importa una lista de imágenes de referencia a conjuntos de productos específicos según una lista de información de las imágenes.

La API google.longrunning.Operation se puede usar para realizar un seguimiento del 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 obtener más información sobre el formato de archivo CSV, consulta ImportProductSetsGcsSource.csv_file_uri.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent	string El 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 con la siguiente estructura:

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

Campos
inputConfig	object (ImportProductSetsInputConfig) El contenido de entrada para la lista de solicitudes.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Operation.

Alcances de autorización

Se necesita uno de los siguientes alcances de OAuth:

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

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

ImportProductSetsInputConfig

El contenido de entrada para el método productSets.import.

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

Campos
gcsSource	object (ImportProductSetsGcsSource) La ubicación de Google Cloud Storage para un archivo CSV que conserva una lista de ImportProductSetRequests en cada línea.

ImportProductSetsGcsSource

La ubicación de Google Cloud Storage para 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 comenzar con gs://. El formato del archivo csv de entrada debe ser una imagen por línea. En cada línea, hay 8 columnas. image-uri image-id product-set-id product-id product-category product-display-name etiquetas bounding-poly Las columnas image-uri, product-set-id, product-id y product-category son obligatorias. Todas las demás columnas son opcionales. Si los valores ProductSet o Product que especifican los valores product-set-id y product-id no existen, el sistema creará un ProductSet o un Product nuevo para la imagen. En este caso, la columna product-display-name se refiere a displayName, la columna product-category se refiere a productCategory y la columna labels se refiere 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 establece el campo displayName del producto en un espacio (“ ”). Puedes actualizar displayName más adelante con 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, en 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 manera que referenceImages.create. Si no especificas la columna bounding-poly, el sistema intentará detectar las regiones de interés de forma automática. Se permite como máximo una columna bounding-poly por línea. Si la imagen contiene varias regiones de interés, agrega una línea al archivo CSV que incluya la misma información de productos y los valores de bounding-poly para cada región de interés. La columna bounding-poly debe contener una cantidad par de números separados por comas, en el formato “p1_x,p1_y,p2_x,p2_y,...,pn_x,pn_y”. Usa números enteros que no sean negativos para polígonos de límite absolutos y valores flotantes en [0, 1] para polígonos de límite normalizados. El sistema cambiará el tamaño de la imagen si la resolución de la imagen es demasiado grande para procesarse (más de 20 MP).