Method: projects.locations.productSets.import

API asynchrone permettant d'importer une liste d'images de référence dans des ensembles de produits spécifiés en fonction d'une liste d'informations concernant ces images.

L'API google.longrunning.Operation permet de suivre la progression et les résultats de la requête. Operation.metadata contient BatchOperationMetadata. (progression) Operation.response contient ImportProductSetsResponse. (résultats)

La source d'entrée de cette méthode est un fichier CSV stocké dans Google Cloud Storage. Pour en savoir plus sur le format du fichier CSV, veuillez consulter la section sur le champ ImportProductSetsGcsSource.csv_file_uri.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Projet dans lequel les ressources ProductSet doivent être importées.

Le format est le suivant : projects/PROJECT_ID/locations/LOC_ID.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "inputConfig": {
    object (ImportProductSetsInputConfig)
  }
}
Champs
inputConfig

object (ImportProductSetsInputConfig)

Contenu d'entrée de la liste de requêtes.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Operation.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

ImportProductSetsInputConfig

Contenu d'entrée de la méthode productSets.import.

Représentation JSON 
{
  "gcsSource": {
    object (ImportProductSetsGcsSource)
  }
}
Champs
gcsSource

object (ImportProductSetsGcsSource)

Emplacement Google Cloud Storage d'un fichier CSV contenant une liste de messages ImportProductSetRequest sur chaque ligne.

ImportProductSetsGcsSource

Emplacement Google Cloud Storage d'un fichier CSV contenant une liste de messages ImportProductSetRequest sur chaque ligne.

Représentation JSON 
{
  "csvFileUri": string
}
Champs
csvFileUri

string

URI Google Cloud Storage du fichier CSV d'entrée.

L'URI doit commencer par gs://.

Le fichier CSV d'entrée doit inclure une image par ligne. Chaque ligne contient huit colonnes.

  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

Les colonnes image-uri, product-set-id, product-id et product-category sont obligatoires. Toutes les autres colonnes sont facultatives.

Si les ressources ProductSet ou Product spécifiées par les valeurs product-set-id et product-id n'existent pas, le système crée une ressource ProductSet ou Product pour l'image. Dans ce cas, la colonne product-display-name fait référence à displayName, la colonne product-category à productCategory et la colonne labels à productLabels.

La colonne image-id est facultative, mais doit être unique si elle est fournie. Si elle est vide, le système attribue automatiquement un identifiant unique à l'image.

La colonne product-display-name est facultative. Si elle est vide, le système définit le champ displayName du produit sur un espace (" "). Vous pouvez mettre à jour le champ displayName ultérieurement à l'aide de l'API.

Si une ressource Product possède déjà une colonne product-id, le système ignore les colonnes product-display-name, product-category et labels.

La colonne labels (facultative) comporte une ligne contenant une liste de paires clé/valeur séparées par des virgules, au format suivant :

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

La colonne bounding-poly (facultative) permet d'identifier une zone d'intérêt sur l'image de la même manière que referenceImages.create. Si vous ne spécifiez pas la colonne bounding-poly, le système tente de détecter automatiquement les zones d'intérêt.

Une seule colonne bounding-poly est autorisée par ligne. Si l'image contient plusieurs zones d'intérêt, ajoutez au fichier CSV une ligne contenant les mêmes informations sur le produit et les valeurs bounding-poly de chaque zone d'intérêt.

La colonne bounding-poly doit contenir un nombre pair de nombres séparés par des virgules, au format "p1_x,p1_y,p2_x,p2_y,...,pn_x,pn_y". Utilisez des nombres entiers non négatifs pour les polygones de délimitation absolus et des valeurs flottantes comprises dans la plage [0, 1] pour les polygones de délimitation normalisés.

Le système redimensionne l'image si sa résolution est trop élevée pour qu'elle puisse être traitée (plus de 20 Mpx).