Method: projects.locations.products.referenceImages.create

Cria e retorna um recurso ReferenceImage.

O campo boundingPoly é opcional. Se boundingPoly não for especificado, o sistema vai tentar detectar regiões de interesse na imagem que sejam compatíveis com a productCategory no produto pai. Se for especificado, a detecção será SEMPRE ignorada. O sistema converte polígonos em retângulos não girados.

O pipeline vai redimensionar a imagem se ela for muito grande para processar (acima de 50 MP).

Erros possíveis:

  • Retorna INVALID_ARGUMENT quando o imageUri está ausente ou tem mais de 4.096 caracteres.
  • Retorna INVALID_ARGUMENT quando o produto não existe.
  • Retorna INVALID_ARGUMENT quando boundingPoly não é fornecido e nada é compatível com a productCategory do produto pai.
  • Retorna INVALID_ARGUMENT quando boundingPoly tem mais de 10 polígonos.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Nome do recurso do produto onde será criada a imagem de referência.

O formato é: projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID

Parâmetros de consulta

Parâmetros
referenceImageId

string

Um ID de recurso fornecido pelo usuário para a ReferenceImage a ser adicionada. Se definido, o servidor tentará usar esse valor como o ID do recurso. Caso já esteja em uso, um erro será retornado com o código ALREADY_EXISTS. Precisa ter no máximo 128 caracteres. Não pode conter o caractere /.

Corpo da solicitação

O corpo da solicitação contém uma instância de ReferenceImage.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta incluirá uma instância de ReferenceImage.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.