Method: projects.locations.products.referenceImages.create

Cria e retorna um novo recurso ReferenceImage.

O campo boundingPoly é opcional. Se boundingPoly não for especificado, o sistema tentará detectar regiões de interesse na imagem que sejam compatíveis com 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 redimensionará a imagem se ela for muito grande para processar (acima de 50 MP).

Erros possíveis:

  • Retorna INVALID_ARGUMENT se o imageUri estiver ausente ou tiver mais de 4096 caracteres.
  • Retorna INVALID_ARGUMENT se o produto não existir.
  • Retorna INVALID_ARGUMENT se não for fornecido boundingPoly e nada será compatível com a productCategory do produto pai.
  • Retorna INVALID_ARGUMENT se boundingPoly tiver mais de 10 polígonos.

Solicitação HTTP

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

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

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. 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 código de recurso fornecido pelo usuário para a ReferenceImage a ser adicionada. Se definido, o servidor tentará usar esse valor como ID do recurso. Se já estiver 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.