Method: projects.generateProductText

Genera un conjunto de respuestas o sugerencias de texto candidatas a partir de la información del producto.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

Es obligatorio. Es el proyecto para realizar una llamada. Debe hacer referencia al proyecto de un llamador. Formato: projects/{project-id}.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "titleExamples": [
    {
      object (TitleExample)
    }
  ],
  "productInfo": {
    object (ProductInfo)
  },
  "outputSpec": {
    object (OutputSpec)
  }
}
Campos
titleExamples[]

object (TitleExample)

Opcional. Proporciona algunos ejemplos creados manualmente de mejoras en los títulos que sean únicos para tu caso de uso. TiDe es una herramienta general que maneja varias categorías de productos, pero es posible que la identidad de tu marca requiera una funcionalidad personalizada. Puedes especificarlo aquí.
productInfo

object (ProductInfo)

Es obligatorio. Es la información disponible sobre el producto. Se usa para informar a los modelos de IA generativa.
outputSpec

object (OutputSpec)

Opcional. Son parámetros de configuración que influyen directamente en el contenido que se genera y en cómo se renderiza ese contenido en la respuesta final.

Cuerpo de la respuesta

Es el texto generado para un producto proporcionado.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "attributes": {
    string: string,
    ...
  },
  "title": {
    object (ProductTextGenerationSuggestion)
  },
  "description": {
    object (ProductTextGenerationSuggestion)
  },
  "metadata": {
    object (ProductTextGenerationMetadata)
  }
}
Campos
attributes

map (key: string, value: string)

Cualquier otro atributo generado

Es un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
title

object (ProductTextGenerationSuggestion)

Es el título generado.
description

object (ProductTextGenerationSuggestion)

Es la descripción generada.
metadata

object (ProductTextGenerationMetadata)

Es información adicional que los clientes pueden querer auditar en relación con la generación.

ProductInfo

Es la información disponible sobre el producto. Se usa para informar a los modelos de IA generativa.

Representación JSON 
{
  "productAttributes": {
    string: string,
    ...
  },
  "productImage": {
    object (Image)
  }
}
Campos
productAttributes

map (key: string, value: string)

Es obligatorio. Es una asignación de todos los atributos de producto disponibles. Esto puede incluir el título, la descripción, la marca, el género, el color, el tamaño, etcétera.

Es un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
productImage

object (Image)

Opcional. Es la imagen asociada al producto.

OutputSpec

Son parámetros de configuración que influyen directamente en el contenido que se genera y en cómo se renderiza ese contenido en la respuesta final.

Representación JSON 
{
  "workflowId": string,
  "tone": string,
  "editorialChanges": string
}
Campos
workflowId

string

Opcional. Es el flujo de trabajo que se ejecutará para los datos de productos proporcionados. Los flujos de trabajo pueden completar el título, la descripción o ambos de la respuesta.
tone

string

Opcional. Es el tono de salida deseado para el texto generado, p. ej., serio o informal.
editorialChanges

string

Opcional. Son los cambios editoriales para los datos de productos generados, p. ej., reemplazar Small por "S", no modificar el color si ya está presente.

TitleExample

Ejemplo elaborado manualmente de una mejora en el título del producto. Estos ejemplos se proporcionan a la IA para mejorar su calidad.

Representación JSON 
{
  "productInfo": {
    string: string,
    ...
  },
  "finalProductInfo": {
    string: string,
    ...
  },
  "titleFormat": string,
  "category": string
}
Campos
productInfo

map (key: string, value: string)

Es obligatorio. Mapa que contiene toda la información del producto existente, p. ej.: {"title": "vestido", "description": "Un vestido rojo", "brand": "VestidosParaTodos"} Cualquier información que puedas usar para completar tu feed de productos.

Es un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
finalProductInfo

map (key: string, value: string)

Es obligatorio. Es un mapa con el mismo formato que productInfo, pero con todas las mejoras incluidas, p. ej., {"brand": "Dresses4All", "product": "dress", "color": "red", ...} Por ahora, ordena estos atributos en el orden en que deseas que aparezcan en el título final. Por ejemplo, el ejemplo anterior se convertirá en: Dresses4All dress | red

Es un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
titleFormat

string

Es obligatorio. Son los atributos o los atributos aproximados que componen el título. Por ejemplo, el título "Google GShoe M" puede tener el formato "marca | producto | tamaño".
category

string

Es obligatorio. Es la categoría del producto. Esto ayuda a la IA a comprender cuándo ciertos ejemplos son más relevantes que otros.

ProductTextGenerationSuggestion

Es el texto generado para un producto, que incluye de forma opcional su Puntuación de calidad.

Representación JSON 
{
  "text": string,
  "score": number,
  "changeSummary": string
}
Campos
text

string

El texto generado
score

number

Es el nivel de calidad asociado con la generación. Es una heurística implementada según los estilos de implementación del equipo de Feedgen.
changeSummary

string

Un breve resumen de todos los cambios que se realizaron.

ProductTextGenerationMetadata

Es un tipo de datos wrapper para cualquier metadato asociado con la generación de texto.

Representación JSON 
{
  "metadata": {
    object
  }
}
Campos
metadata

object (Struct format)

Los metadatos son un concepto bastante amplio. Aquí, los datos se modelan como un mapa para indicar que no hay una estructura garantizada para el resultado más allá de una simple asociación clave:valor. El primer caso de uso es hacer un seguimiento de las palabras agregadas, quitadas o modificadas en las generaciones.