Method: projects.locations.products.referenceImages.create

Crée et affiche une ressource ReferenceImage.

Le champ boundingPoly est facultatif. Si boundingPoly n'est pas spécifié, le système essaie de détecter les zones d'intérêt de l'image qui sont compatibles avec le champ "productCategory" du produit parent. Si ce champ est spécifié, la détection est TOUJOURS ignorée. Le système convertit les polygones en rectangles non pivotants.

Notez que le pipeline redimensionne l'image si sa résolution est trop élevée pour être traitée (plus de 50 Mpx).

Erreurs possibles :

  • Renvoie INVALID_ARGUMENT si le champ "imageUri" est manquant ou comporte plus de 4 096 caractères.
  • Renvoie INVALID_ARGUMENT si le produit n'existe pas.
  • Renvoie INVALID_ARGUMENT si le champ "boundingPoly" n'est pas fourni et si aucun élément compatible avec le champ "productCategory" du produit parent n'est détecté.
  • Renvoie INVALID_ARGUMENT si le champ "boundingPoly" contient plus de 10 polygones.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Nom de ressource du produit dans lequel créer l'image de référence.

Format : projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID

Paramètres de requête

Paramètres
referenceImageId

string

ID de ressource fourni par l'utilisateur pour l'image ReferenceImage à ajouter. Si ce champ est défini, le serveur tente d'utiliser cette valeur en tant qu'ID de ressource. Si elle est déjà utilisée, une erreur est renvoyée avec le code ALREADY_EXISTS. Doit contenir au maximum 128 caractères. Ne peut pas inclure le caractère /.

Corps de la requête

Le corps de la requête contient une instance de ReferenceImage.

Corps de la réponse

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

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 Présentation de l'authentification.