- Richiesta HTTP
- Parametri del percorso
- Parametri di query
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
Crea e restituisce una nuova risorsa ReferenceImage.
Il campo boundingPoly è facoltativo. Se non viene specificato boundingPoly, il sistema tenterà di rilevare regioni di interesse nell'immagine compatibili con la categoria di prodotto del prodotto principale. Se viene specificato, il rilevamento viene SEMPRE ignorato. Il sistema converte i poligoni in rettangoli non ruotati.
Tieni presente che la pipeline ridimensionerà l'immagine se la risoluzione è troppo elevata per l'elaborazione (oltre 50 MP).
Possibili errori:
- Restituisce INVALID_ARGUMENT se imageUri non è presente o è più lungo di 4096 caratteri.
- Restituisce INVALID_ARGUMENT se il prodotto non esiste.
- Restituisce INVALID_ARGUMENT se boundingPoly non viene fornito e non viene rilevato nulla di compatibile con la categoria di prodotto del prodotto principale.
- Restituisce INVALID_ARGUMENT se boundingPoly contiene più di 10 poligoni.
Richiesta HTTP
POST https://vision.googleapis.com/v1/{parent=projects/*/locations/*/products/*}/referenceImages
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
| Parametri | |
|---|---|
parent |
Obbligatorio. Nome della risorsa del prodotto in cui creare l'immagine di riferimento. Il formato è |
Parametri di query
| Parametri | |
|---|---|
referenceImageId |
Un ID risorsa fornito dall'utente per l'immagine di riferimento da aggiungere. Se impostato, il server tenterà di utilizzare questo valore come ID risorsa. Se è già in uso, viene restituito un errore con il codice ALREADY_EXISTS. Deve avere una lunghezza massima di 128 caratteri. Non può contenere il carattere |
Corpo della richiesta
Il corpo della richiesta contiene un'istanza di ReferenceImage.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di ReferenceImage appena creata.
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/cloud-platformhttps://www.googleapis.com/auth/cloud-vision
Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.