- Solicitud HTTP
- Parámetros de ruta
- Parámetros de consulta
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de la autorización
Crea y devuelve un nuevo recurso ReferenceImage.
El campo boundingPoly es opcional. Si no se especifica boundingPoly, el sistema intentará detectar regiones de interés en la imagen que sean compatibles con el valor de productCategory del producto principal. Si se especifica, la detección SIEMPRE se omite. El sistema convierte los polígonos en rectángulos sin rotar.
Ten en cuenta que la canalización cambiará el tamaño de la imagen si su resolución es demasiado grande para procesarla (más de 50 MP).
A continuación se indican los posibles errores.
- Devuelve INVALID_ARGUMENT si falta el valor de imageUri o si supera los 4096 caracteres.
- Devuelve INVALID_ARGUMENT si el producto no existe.
- Devuelve INVALID_ARGUMENT si no se proporciona boundingPoly y no se detecta nada compatible con productCategory del producto principal.
- Devuelve INVALID_ARGUMENT si boundingPoly contiene más de 10 polígonos.
Solicitud HTTP
POST https://vision.googleapis.com/v1/{parent=projects/*/locations/*/products/*}/referenceImages
La URL utiliza la sintaxis de transcodificación a gRPC.
Parámetros de ruta
| Parámetros | |
|---|---|
parent |
Obligatorio. Nombre de recurso del producto en el que se va a crear la imagen de referencia. El formato es |
Los parámetros de consulta
| Parámetros | |
|---|---|
referenceImageId |
ID de recurso proporcionado por el usuario de la imagen de referencia que se va a añadir. Si se define, el servidor intentará usar este valor como ID de recurso. Si ya se está usando, se devuelve un error con el código ALREADY_EXISTS. Debe tener 128 caracteres como máximo. No puede contener el carácter |
Cuerpo de la solicitud
En el cuerpo de la solicitud se incluye una instancia de ReferenceImage.
Cuerpo de la respuesta
Si la solicitud se completa correctamente, en el cuerpo de la respuesta se incluye una instancia recién creada de ReferenceImage.
Permisos de autorización
Debes disponer de uno de los siguientes permisos de OAuth:
https://www.googleapis.com/auth/cloud-platformhttps://www.googleapis.com/auth/cloud-vision
Para obtener más información, consulta el artículo Descripción general de la autenticación.