Method: projects.locations.productSets.import

Asynchrone API, die basierend auf einer Liste von Bildinformationen eine Liste von Referenzbildern in bestimmte ProductSets importiert.

Mit der google.longrunning.Operation API können Sie den Fortschritt und die Ergebnisse der Anfrage verfolgen. Operation.metadata enthält BatchOperationMetadata. (Fortschritt) Operation.response enthält ImportProductSetsResponse. (Ergebnisse)

Die Eingabequelle dieser Methode ist eine CSV-Datei in Google Cloud Storage. Das Format der CSV-Datei finden Sie unter ImportProductSetsGcsSource.csv_file_uri.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Das Projekt, in das die ProductSets importiert werden sollen.

Das Format ist projects/PROJECT_ID/locations/LOC_ID.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "inputConfig": {
    object (ImportProductSetsInputConfig)
  }
}
Felder
inputConfig

object (ImportProductSetsInputConfig)

Der Eingabeinhalt für die Liste der Anfragen.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Operation.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

ImportProductSetsInputConfig

Der Eingabeinhalt für die Methode productSets.import.

JSON-Darstellung 
{
  "gcsSource": {
    object (ImportProductSetsGcsSource)
  }
}
Felder
gcsSource

object (ImportProductSetsGcsSource)

Der Google Cloud Storage-Speicherort für eine CSV-Datei, die in jeder Zeile eine Liste von ImportProductSetRequests enthält.

ImportProductSetsGcsSource

Der Google Cloud Storage-Speicherort für eine CSV-Datei, die in jeder Zeile eine Liste von ImportProductSetRequests enthält.

JSON-Darstellung 
{
  "csvFileUri": string
}
Felder
csvFileUri

string

Der Google Cloud Storage-URI der CSV-Eingabedatei.

Der URI muss mit gs:// beginnen.

Das Format der CSV-Eingabedatei sollte ein Bild pro Zeile sein. In jeder Zeile sind acht Spalten vorhanden.

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

Die Spalten image-uri, product-set-id, product-id und product-category sind erforderlich. Alle anderen Spalten sind optional.

Wenn die ProductSet- und Product-Werte, die in den Werten product-set-id und product-id angegeben sind, nicht vorhanden sind, erstellt das System ein neues ProductSet oder Product für das Image. In diesem Fall verweist die Spalte product-display-name auf displayName, die Spalte product-category auf productCategory und die Spalte labels auf productLabels.

Die Spalte image-id ist optional, muss aber eindeutig sein, wenn sie angegeben wird. Wenn sie leer ist, weist das System dem Bild automatisch eine eindeutige ID zu.

Die Spalte product-display-name ist optional. Wenn dieser Wert leer ist, setzt das System das Feld displayName für das Produkt auf ein Leerzeichen („ “). Sie können displayName später mithilfe der API aktualisieren.

Wenn ein Product mit der angegebenen product-id bereits vorhanden ist, ignoriert das System die Spalten product-display-name, product-category und labels.

Die Spalte labels (optional) ist eine Zeile, die eine Liste mit durch Kommas getrennten Schlüssel/Wert-Paaren im folgenden Format enthält:

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

In der Spalte bounding-poly (optional) wird ein bestimmter Bereich eines Bilds aus dem Bild auf die gleiche Weise aufgeführt wie referenceImages.create. Wenn Sie die Spalte bounding-poly nicht angeben, versucht das System, Regionen von Interesse automatisch zu erkennen.

Pro Zeile ist maximal eine Spalte bounding-poly zulässig. Wenn das Bild mehrere relevante Regionen enthält, fügen Sie der CSV-Datei eine Zeile mit denselben Produktinformationen und den bounding-poly-Werten für die einzelnen Regionen hinzu.

Die Spalte bounding-poly muss eine gerade Anzahl durch Kommas getrennter Zahlen im Format „p1_x,p1_y,p2_x,p2_y,...,pn_x,pn_y“ enthalten. Verwenden Sie für absolute Begrenzungspolygone nicht negative Ganzzahlen und für normalisierte Begrenzungspolygone Gleitkommawerte in [0, 1].

Die Größe des Bildes wird vom System angepasst, wenn das Bild zu groß für die Verarbeitung ist (größer als 20 MP).