Method: projects.locations.products.referenceImages.create

Crea y muestra un recurso ReferenceImage nuevo.

El campo boundingPoly es opcional. Si no se especifica boundingPoly, el sistema intentará detectar las regiones de interés en la imagen que sean compatibles con el productCategory en el producto superior. Si se especifica, la detección se realiza en SIEMPRE omitida. El sistema convierte los polígonos en rectángulos no rotados.

Tenga en cuenta que la canalización cambiará el tamaño de la imagen si la resolución de la imagen es demasiado grande para procesarse (más de 50 MP).

A continuación, se indican los posibles errores.

  • Muestra INVALID_ARGUMENT si falta el valor image_uri o es superior a 4,096 caracteres.
  • Muestra INVALID_ARGUMENT si el producto no existe.
  • Muestra INVALID_ARGUMENT si no se proporciona bounding_poly y no se detecta nada compatible con el product_category del producto superior.
  • Muestra INVALID_ARGUMENT si bounding_poly contiene más de 10 polígonos.

Solicitud HTTP

POST https://vision.googleapis.com/v1/{parent=projects/*/locations/*/products/*}/referenceImages

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

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. Nombre del recurso en el que se creará la imagen de referencia.

El formato es projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID.

Parámetros de consulta

Parámetros
referenceImageId

string

Un ID de recurso proporcionado por el usuario para que se agregue la ReferenceImage. Si se configura, el servidor intentará usar este valor como el ID del recurso. Si ya está en uso, se muestra un error con el código ALREADY_EXISTS. Debe tener como máximo 128 caracteres. No puede contener el carácter /.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene una instancia de ReferenceImage.

Cuerpo de la respuesta

Si el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada de ReferenceImage.

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.