Method: projects.generateProductTextAttributes

Génère les attributs manquants à partir des informations produit.

Requête HTTP

POST https://productstudio.googleapis.com/v1/{parent=projects/*}:generateProductTextAttributes

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Projet pour passer un appel. Doit faire référence au projet d'un appelant. Format : projects/{project-id}.

Corps de la requête

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

Représentation JSON 
{
  "inputAttributes": [
    {
      object (Attribute)
    }
  ],
  "generativeAttributes": [
    {
      object (Attribute)
    }
  ],
  "offerImage": {
    object (Image)
  },
  "clientRequestContext": {
    object (ClientRequestContext)
  },
  "allowAnyConfidenceSuggestions": boolean
}
Champs
inputAttributes[]

object (Attribute)

Facultatif. Attributs d'entrée utilisés pour générer les suggestions. Les valeurs acceptées sont "title" (titre) et "description". Ces attributs ne seront pas inclus dans la réponse et ne changeront pas.
generativeAttributes[]

object (Attribute)

Obligatoire. Attributs à générer. Les valeurs acceptées sont "sexe", "tranche d'âge", "couleur" et "taille". Au moins l'une de ces valeurs doit être définie. Seules les valeurs définies ici seront incluses dans la réponse.
offerImage

object (Image)

Obligatoire. Image associée au produit.
clientRequestContext

object (ClientRequestContext)

Obligatoire. Informations sur le client à l'origine de la requête.
allowAnyConfidenceSuggestions

boolean

Facultatif. Si la valeur est "true", les suggestions d'attributs avec tous les niveaux de confiance seront incluses dans la réponse. Par défaut, seules les suggestions très fiables sont incluses pour tous les attributs.

Corps de la réponse

Réponse pour projects.generateProductTextAttributes.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "suggestions": [
    {
      object (Attribute)
    }
  ]
}
Champs
suggestions[]

object (Attribute)

Suggestions d'attributs de produits générées. Ce champ peut être vide si le modèle n'est pas en mesure de suggérer des attributs avec des scores de confiance suffisants. Les suggestions peuvent concerner le genre, la tranche d'âge, la couleur et la taille, en fonction des attributs à générer dans la requête.

Attribut

Attribut de produit utilisé dans la requête et la réponse.

Représentation JSON 
{
  "key": string,
  "textValue": string,
  "confidenceLevel": enum (ConfidenceLevel)
}
Champs
key

string

Obligatoire. Nom de l'attribut tel que fourni par le marchand.
textValue

string

Facultatif. Stocke la valeur textuelle de l'attribut. Cette valeur doit être définie pour inputAttributes dans GenerateProductTextAttributesRequest et pour les suggestions dans GenerateProductTextAttributesResponse. Seuls les attributs de texte sont utilisés/générés à ce stade. Par conséquent, attribute_type(par exemple, INT, RICH_TEXT) et les autres format_values(par exemple, float_value, rich_text_value) ne sont pas définis.
confidenceLevel

enum (ConfidenceLevel)

Facultatif. Cette valeur n'est présente que dans la réponse et détermine le niveau de confiance de la suggestion d'attribut générée.

ConfidenceLevel

Niveau de confiance de la suggestion d'attribut générée par le modèle d'IA. Le modèle génère un score de confiance pour chaque suggestion, qui est ensuite classé dans l'un des niveaux de confiance. Les seuils de confiance pour chaque catégorie ont été déterminés en fonction des évaluations humaines des résultats du modèle.

Enums
CONFIDENCE_LEVEL_UNSPECIFIED Niveau de confiance non spécifié.
LOW Niveau de confiance faible.
MEDIUM Niveau de confiance moyen.
HIGH Niveau de confiance élevé.

ClientRequestContext

Informations sur le client à l'origine de la demande.

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

string

Obligatoire. ID du produit défini par le partenaire.