Method: projects.locations.productSets.import

API asincrona che importa un elenco di immagini di riferimento in set di prodotti specificati in base a un elenco di informazioni sulle immagini.

L'API google.longrunning.Operation può essere utilizzata per monitorare l'avanzamento e i risultati della richiesta. Operation.metadata contiene BatchOperationMetadata. (progress) Operation.response contiene ImportProductSetsResponse. (risultati)

L'origine di input di questo metodo è un file CSV su Google Cloud Storage. Per il formato del file CSV, consulta ImportProductSetsGcsSource.csv_file_uri.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Il progetto in cui devono essere importati i set di prodotti.

Il formato è projects/PROJECT_ID/locations/LOC_ID.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "inputConfig": {
    object (ImportProductSetsInputConfig)
  }
}
Campi
inputConfig

object (ImportProductSetsInputConfig)

I contenuti inseriti per l'elenco delle richieste.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

ImportProductSetsInputConfig

I contenuti di input per il metodo productSets.import.

Rappresentazione JSON 
{
  "gcsSource": {
    object (ImportProductSetsGcsSource)
  }
}
Campi
gcsSource

object (ImportProductSetsGcsSource)

La posizione di Google Cloud Storage per un file CSV che conserva un elenco di ImportProductSetRequests in ogni riga.

ImportProductSetsGcsSource

La posizione di Google Cloud Storage per un file CSV che conserva un elenco di ImportProductSetRequests in ogni riga.

Rappresentazione JSON 
{
  "csvFileUri": string
}
Campi
csvFileUri

string

L'URI Google Cloud Storage del file CSV di input.

L'URI deve iniziare con gs://.

Il formato del file CSV di input deve essere di un'immagine per riga. In ogni riga sono presenti 8 colonne.

  1. image-uri
  2. image-id
  3. product-set-id
  4. product-id
  5. product-category
  6. product-display-name
  7. etichette
  8. bounding-poly

Le colonne image-uri, product-set-id, product-id e product-category sono obbligatorie. Tutte le altre colonne sono facoltative.

Se il ProductSet o il Product specificato dai valori product-set-id e product-id non esiste, il sistema creerà un nuovo ProductSet o Product per l'immagine. In questo caso, la colonna product-display-name fa riferimento a displayName, la colonna product-category fa riferimento a productCategory e la colonna labels fa riferimento a productLabels.

La colonna image-id è facoltativa, ma deve essere univoca se specificata. Se è vuoto, il sistema assegnerà automaticamente un ID univoco all'immagine.

La colonna product-display-name è facoltativa. Se è vuoto, il sistema imposta il campo displayName per il prodotto su uno spazio (" "). Puoi aggiornare displayName in un secondo momento utilizzando l'API.displayName

Se esiste già un Product con il product-id specificato, il sistema ignora le colonne product-display-name, product-category e labels.

La colonna labels (facoltativa) è una riga contenente un elenco di coppie chiave-valore separate da virgola nel seguente formato:

"key_1=value_1,key_2=value_2,...,key_n=value_n"

La colonna bounding-poly (facoltativa) identifica una regione di interesse dell'immagine nello stesso modo di referenceImages.create. Se non specifichi la colonna bounding-poly, il sistema tenterà di rilevare automaticamente le regioni di interesse.

È consentita al massimo una colonna bounding-poly per riga. Se l'immagine contiene più regioni di interesse, aggiungi una riga al file CSV che includa le stesse informazioni sul prodotto e i valori bounding-poly per ogni regione di interesse.

La colonna bounding-poly deve contenere un numero pari di numeri separati da virgola, nel formato "p1_x,p1_y,p2_x,p2_y,…,pn_x,pn_y". Utilizza numeri interi non negativi per i poligoni delimitanti assoluti e valori in virgola mobile nell'intervallo [0, 1] per i poligoni delimitanti normalizzati.

Il sistema ridimensionerà l'immagine se la risoluzione è troppo elevata per essere elaborata (superiore a 20 MP).