Method: projects.generateProductTextAttributes

Gera atributos ausentes com base nas informações do produto.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. Projeto para fazer uma chamada. Precisa se referir ao projeto de um autor da chamada. Formato: projects/{project-id}.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "inputAttributes": [
    {
      object (Attribute)
    }
  ],
  "generativeAttributes": [
    {
      object (Attribute)
    }
  ],
  "offerImage": {
    object (Image)
  },
  "clientRequestContext": {
    object (ClientRequestContext)
  },
  "allowAnyConfidenceSuggestions": boolean
}
Campos
inputAttributes[]

object (Attribute)

Opcional. Os atributos de entrada usados para gerar as sugestões. Os valores aceitos são: title, description. Esses atributos não serão incluídos na resposta e não vão mudar.
generativeAttributes[]

object (Attribute)

Obrigatório. Atributos a serem gerados. Os valores aceitos são gênero, idade, cor e tamanho. Pelo menos um deles precisa ser definido. Somente os valores definidos aqui serão incluídos na resposta.
offerImage

object (Image)

Obrigatório. Imagem associada ao produto.
clientRequestContext

object (ClientRequestContext)

Obrigatório. Informações sobre o cliente que está fazendo a solicitação.
allowAnyConfidenceSuggestions

boolean

Opcional. Se for verdadeiro, as sugestões de atributos com todos os níveis de confiança serão incluídas na resposta. Por padrão, apenas sugestões de alta confiança são incluídas para todos os atributos.

Corpo da resposta

Resposta para "projects.generateProductTextAttributes".

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "suggestions": [
    {
      object (Attribute)
    }
  ]
}
Campos
suggestions[]

object (Attribute)

As sugestões de atributos de produtos geradas. Pode estar vazio se o modelo não conseguir sugerir atributos com pontuações de confiança suficientes. As sugestões podem ser de gênero, faixa etária, cor e tamanho com base nos atributos_a_gerar na solicitação.

Atributo

Um atributo de produto usado na solicitação e na resposta.

Representação JSON 
{
  "key": string,
  "textValue": string,
  "confidenceLevel": enum (ConfidenceLevel)
}
Campos
key

string

Obrigatório. Nome do atributo fornecido pelo comerciante.
textValue

string

Opcional. Armazena o valor de texto do atributo. Isso precisa ser definido para inputAttributes em GenerateProductTextAttributesRequest e para sugestões em GenerateProductTextAttributesResponse. Neste momento, apenas atributos de texto são usados/gerados. Portanto, attribute_type(por exemplo, INT, RICH_TEXT) e outros format_values(por exemplo, float_value, rich_text_value) não são definidos.
confidenceLevel

enum (ConfidenceLevel)

Opcional. Isso está presente apenas na resposta e determina o nível de confiança da sugestão de atributo gerada.

ConfidenceLevel

O nível de confiança da sugestão de atributo gerada pelo modelo de IA. O modelo gera uma pontuação de confiança para cada sugestão, que é agrupada em um dos níveis de confiança. Os limites de confiança de cada grupo foram determinados com base em avaliações humanas das respostas do modelo.

Enums
CONFIDENCE_LEVEL_UNSPECIFIED Nível de confiança não especificado.
LOW Nível de confiança baixo.
MEDIUM Nível de confiança médio.
HIGH Nível de confiança alto.

ClientRequestContext

Informações sobre o cliente que está fazendo a solicitação.

Representação JSON 
{
  "partnerProductId": string
}
Campos
partnerProductId

string

Obrigatório. O ID do produto definido pelo parceiro.