Method: projects.generateProductText

Génère un ensemble de réponses/complétions de texte candidates à partir d'informations sur le produit.

Requête HTTP

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

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 
{
  "titleExamples": [
    {
      object (TitleExample)
    }
  ],
  "productInfo": {
    object (ProductInfo)
  },
  "outputSpec": {
    object (OutputSpec)
  }
}
Champs
titleExamples[]

object (TitleExample)

Facultatif. Fournissez quelques exemples de titres améliorés qui sont propres à votre cas d'utilisation. TiDe est un outil général qui gère plusieurs catégories de produits, mais l'identité de votre marque peut nécessiter des fonctionnalités personnalisées. N'hésitez pas à le préciser ici.
productInfo

object (ProductInfo)

Obligatoire. Informations disponibles sur le produit. Utilisées pour informer les modèles d'IA générative.
outputSpec

object (OutputSpec)

Facultatif. Paramètres de configuration qui influencent directement le contenu généré et la façon dont il est affiché dans la réponse finale.

Corps de la réponse

Texte généré pour un produit fourni.

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

Représentation JSON 
{
  "attributes": {
    string: string,
    ...
  },
  "title": {
    object (ProductTextGenerationSuggestion)
  },
  "description": {
    object (ProductTextGenerationSuggestion)
  },
  "metadata": {
    object (ProductTextGenerationMetadata)
  }
}
Champs
attributes

map (key: string, value: string)

Tout autre attribut généré

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.
title

object (ProductTextGenerationSuggestion)

Titre généré.
description

object (ProductTextGenerationSuggestion)

Description générée.
metadata

object (ProductTextGenerationMetadata)

Informations supplémentaires que les clients peuvent souhaiter auditer concernant la génération.

ProductInfo

Informations disponibles sur le produit. Utilisées pour informer les modèles d'IA générative.

Représentation JSON 
{
  "productAttributes": {
    string: string,
    ...
  },
  "productImage": {
    object (Image)
  }
}
Champs
productAttributes

map (key: string, value: string)

Obligatoire. Mappage de tous les attributs de produit disponibles. Il peut s'agir du titre, de la description, de la marque, du genre, de la couleur, de la taille, etc.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.
productImage

object (Image)

Facultatif. Image associée au produit.

OutputSpec

Paramètres de configuration qui influencent directement le contenu généré et la façon dont il est affiché dans la réponse finale.

Représentation JSON 
{
  "workflowId": string,
  "tone": string,
  "editorialChanges": string
}
Champs
workflowId

string

Facultatif. Workflow à exécuter pour les données produit fournies. Les workflows peuvent renseigner le titre, la description ou les deux dans la réponse.
tone

string

Facultatif. Le ton de sortie souhaité pour le texte généré (par exemple, sérieux ou décontracté).
editorialChanges

string

Facultatif. Toute modification éditoriale apportée aux données produit générées (par exemple, remplacer "Petit" par "S", ne pas modifier la couleur si elle est déjà présente).

TitleExample

Exemple de titre de produit amélioré manuellement. Ces exemples sont fournis à l'IA pour améliorer sa qualité.

Représentation JSON 
{
  "productInfo": {
    string: string,
    ...
  },
  "finalProductInfo": {
    string: string,
    ...
  },
  "titleFormat": string,
  "category": string
}
Champs
productInfo

map (key: string, value: string)

Obligatoire. Une carte contenant toutes les informations sur les produits existants. Par exemple : {"title": "dress", "description": "A red dress", "brand": "Dresses4All"} Toutes les informations que vous pouvez utiliser pour remplir votre flux de produits.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.
finalProductInfo

map (key: string, value: string)

Obligatoire. Carte au même format que productInfo, mais avec toutes les améliorations incluses. Par exemple : {"brand": "Dresses4All", "product": "dress", "color": "red", ...} Pour l'instant, ordonnez ces attributs dans l'ordre dans lequel vous souhaitez qu'ils apparaissent dans le titre final. Par exemple, le titre ci-dessus deviendra : Dresses4All dress | red

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.
titleFormat

string

Obligatoire. Attributs ou attributs approximatifs qui composent le titre. Par exemple, pour le titre "Google GShoe M", titleFormat peut être "brand | product | size".
category

string

Obligatoire. Catégorie du produit. Cela aide l'IA à comprendre quand certains exemples sont plus pertinents que d'autres.

ProductTextGenerationSuggestion

Texte généré pour un produit, incluant éventuellement son score de qualité.

Représentation JSON 
{
  "text": string,
  "score": number,
  "changeSummary": string
}
Champs
text

string

Le texte généré
score

number

Niveau de qualité associé à la génération. Heuristique implémentée selon les styles d'implémentation de l'équipe Feedgen.
changeSummary

string

Un bref résumé de toutes les modifications apportées.

ProductTextGenerationMetadata

Type de données wrapper pour toutes les métadonnées associées à la génération de texte.

Représentation JSON 
{
  "metadata": {
    object
  }
}
Champs
metadata

object (Struct format)

Les métadonnées sont un concept assez vague. Les données sont modélisées sous forme de carte ici pour indiquer qu'il n'y a pas de structure garantie pour la sortie au-delà d'une simple association K:V. Le premier cas d'utilisation consiste à suivre les mots ajoutés, supprimés ou modifiés dans les générations.