Method: projects.generateProductTextAttributes

Genera los atributos faltantes a partir de la información del producto.

Solicitud HTTP

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

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 
{
  "inputAttributes": [
    {
      object (Attribute)
    }
  ],
  "generativeAttributes": [
    {
      object (Attribute)
    }
  ],
  "offerImage": {
    object (Image)
  },
  "clientRequestContext": {
    object (ClientRequestContext)
  },
  "allowAnyConfidenceSuggestions": boolean
}
Campos
inputAttributes[]

object (Attribute)

Opcional. Son los atributos de entrada que se usan para generar las sugerencias. Los valores admitidos son title y description. Estos atributos no se incluirán en la respuesta y no cambiarán.
generativeAttributes[]

object (Attribute)

Es obligatorio. Son los atributos que se generarán. Los valores admitidos son género, edad, color y tamaño, y se debe establecer al menos uno de esos valores. Solo los valores establecidos aquí se incluirán en la respuesta.
offerImage

object (Image)

Es obligatorio. Es la imagen asociada al producto.
clientRequestContext

object (ClientRequestContext)

Es obligatorio. Es la información sobre el cliente que realiza la solicitud.
allowAnyConfidenceSuggestions

boolean

Opcional. Si es verdadero, se incluirán en la respuesta sugerencias de atributos con todos los niveles de confianza. De forma predeterminada, solo se incluyen sugerencias con un alto nivel de confianza para todos los atributos.

Cuerpo de la respuesta

Es la respuesta para projects.generateProductTextAttributes.

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

Representación JSON 
{
  "suggestions": [
    {
      object (Attribute)
    }
  ]
}
Campos
suggestions[]

object (Attribute)

Son las sugerencias de atributos del producto generadas. Puede estar vacío si el modelo no puede sugerir atributos con suficientes puntuaciones de confianza. Las sugerencias pueden ser de género, edad, color y tamaño según los atributos_para_generar en la solicitud.

Atributo

Es un atributo del producto que se usa en la solicitud y la respuesta.

Representación JSON 
{
  "key": string,
  "textValue": string,
  "confidenceLevel": enum (ConfidenceLevel)
}
Campos
key

string

Es obligatorio. Es el nombre del atributo tal como lo proporciona el comercio.
textValue

string

Opcional. Almacena el valor de texto del atributo. Se debe configurar para inputAttributes en GenerateProductTextAttributesRequest y para las sugerencias en GenerateProductTextAttributesResponse. En este punto, solo se usan o generan atributos de texto, por lo que no se definen attribute_type(p. ej., INT, RICH_TEXT) ni otros format_values(p. ej., float_value, rich_text_value).
confidenceLevel

enum (ConfidenceLevel)

Opcional. Este campo solo está presente en la respuesta y determinará el nivel de confianza de la sugerencia de atributo generada.

ConfidenceLevel

Es el nivel de confianza de la sugerencia de atributo que genera el modelo de IA. El modelo genera una puntuación de confianza para cada sugerencia y la agrupa en uno de los niveles de confianza. Los umbrales de confianza para cada discretización se determinaron en función de las evaluaciones humanas de los resultados del modelo.

Enumeraciones
CONFIDENCE_LEVEL_UNSPECIFIED Nivel de confianza no especificado.
LOW Nivel de confianza bajo.
MEDIUM Nivel de confianza medio.
HIGH Nivel de confianza alto.

ClientRequestContext

Es la información sobre el cliente que realiza la solicitud.

Representación JSON 
{
  "partnerProductId": string
}
Campos
partnerProductId

string

Es obligatorio. Es el ID del producto que define el socio.