Method: projects.locations.products.referenceImages.create

Crea e restituisce una nuova risorsa ReferenceImage.

Il campo boundingPoly è facoltativo. Se boundingPoly non è specificato, il sistema tenterà di rilevare le regioni di interesse nell'immagine compatibili con productCategory nel 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 essere elaborata (superiore a 50 MP).

Possibili errori:

  • Restituisce INVALID_ARGUMENT se imageUri è mancante 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 productCategory del prodotto principale.
  • Restituisce INVALID_ARGUMENT se boundingPoly contiene più di 10 poligoni.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Nome della risorsa del prodotto in cui creare l'immagine di riferimento.

Il formato è projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID.

Parametri di query

Parametri
referenceImageId

string

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-platform
  • https://www.googleapis.com/auth/cloud-vision

Per saperne di più, consulta Panoramica dell'autenticazione.

Prova