Method: projects.locations.products.referenceImages.create

Cria e devolve um novo recurso ReferenceImage.

O campo boundingPoly é opcional. Se boundingPoly não for especificado, o sistema tenta detetar regiões de interesse na imagem que sejam compatíveis com productCategory no produto principal. Se for especificado, a deteção é SEMPRE ignorada. O sistema converte polígonos em retângulos não rodados.

Tenha em atenção que o pipeline redimensiona a imagem se a resolução da imagem for demasiado grande para processamento (acima de 50 MP).

Possíveis erros:

  • Devolve INVALID_ARGUMENT se o imageUri estiver em falta ou tiver mais de 4096 carateres.
  • Devolve INVALID_ARGUMENT se o produto não existir.
  • Devolve INVALID_ARGUMENT se boundingPoly não for fornecido e não for detetado nada compatível com productCategory do produto principal.
  • Devolve INVALID_ARGUMENT se boundingPoly contiver mais de 10 polígonos.

Pedido HTTP

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

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

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. Nome do recurso do produto no qual criar 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 do recurso fornecido pelo utilizador para a ReferenceImage a adicionar. Se estiver definido, o servidor tenta usar este valor como o ID do recurso. Se já estiver em utilização, é devolvido um erro com o código ALREADY_EXISTS. Tem de ter, no máximo, 128 carateres. Não pode conter o caráter /.

Corpo do pedido

O corpo do pedido contém uma instância de ReferenceImage.

Corpo da resposta

Se for bem-sucedido, o corpo da resposta contém uma instância recém-criada de ReferenceImage.

Âmbitos de autorização

Requer um dos seguintes âmbitos do OAuth:

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

Para mais informações, consulte a Vista geral da autenticação.