Method: projects.generateProductTextAttributes

Genera gli attributi mancanti dalle informazioni sul prodotto.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. Proietta per effettuare una chiamata. Deve fare riferimento al progetto di un chiamante. Formato: projects/{project-id}.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "inputAttributes": [
    {
      object (Attribute)
    }
  ],
  "generativeAttributes": [
    {
      object (Attribute)
    }
  ],
  "offerImage": {
    object (Image)
  },
  "clientRequestContext": {
    object (ClientRequestContext)
  },
  "allowAnyConfidenceSuggestions": boolean
}
Campi
inputAttributes[]

object (Attribute)

(Facoltativo) Gli attributi di input utilizzati per generare i suggerimenti. I valori supportati sono: titolo, descrizione. Questi attributi non verranno inclusi nella risposta e non verranno modificati.
generativeAttributes[]

object (Attribute)

Obbligatorio. Attributi da generare. I valori supportati sono genere, età, colore e taglia e almeno uno di questi valori deve essere impostato. Nella risposta verranno inclusi solo i valori impostati qui.
offerImage

object (Image)

Obbligatorio. Immagine associata al prodotto.
clientRequestContext

object (ClientRequestContext)

Obbligatorio. Informazioni sul client che effettua la richiesta.
allowAnyConfidenceSuggestions

boolean

(Facoltativo) Se il valore è true, nella risposta verranno inclusi suggerimenti per gli attributi con tutti i livelli di confidenza. Per impostazione predefinita, per tutti gli attributi vengono inclusi solo i suggerimenti ad alta affidabilità.

Corpo della risposta

Risposta per projects.generateProductTextAttributes.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "suggestions": [
    {
      object (Attribute)
    }
  ]
}
Campi
suggestions[]

object (Attribute)

I suggerimenti generati per gli attributi di prodotto. Può essere vuoto se il modello non è in grado di suggerire attributi con punteggi di confidenza sufficienti. I suggerimenti possono essere di genere, età, colore e taglia in base agli attributi_da_generare nella richiesta.

Attributo

Un attributo del prodotto utilizzato nella richiesta e nella risposta.

Rappresentazione JSON 
{
  "key": string,
  "textValue": string,
  "confidenceLevel": enum (ConfidenceLevel)
}
Campi
key

string

Obbligatorio. Nome dell'attributo fornito dal commerciante.
textValue

string

(Facoltativo) Memorizza il valore di testo dell'attributo. Questo valore deve essere impostato per inputAttributes in GenerateProductTextAttributesRequest e per i suggerimenti in GenerateProductTextAttributesResponse. In questa fase vengono utilizzati/generati solo gli attributi di testo, pertanto non sono definiti attribute_type(ad es. INT, RICH_TEXT) e altri format_values(ad es. float_value, rich_text_value).
confidenceLevel

enum (ConfidenceLevel)

(Facoltativo) Questo valore è presente solo nella risposta e determina il livello di confidenza del suggerimento dell'attributo generato.

ConfidenceLevel

Il livello di confidenza del suggerimento dell'attributo generato dal modello di AI. Il modello restituisce un punteggio di affidabilità per ogni suggerimento, che viene inserito in uno dei livelli di affidabilità. Le soglie di confidenza per ogni bucket sono state determinate in base alle valutazioni umane degli output del modello.

Enum
CONFIDENCE_LEVEL_UNSPECIFIED Livello di confidenza non specificato.
LOW Livello di confidenza basso.
MEDIUM Livello di confidenza medio.
HIGH Livello di confidenza elevato.

ClientRequestContext

Informazioni sul cliente che effettua la richiesta.

Rappresentazione JSON 
{
  "partnerProductId": string
}
Campi
partnerProductId

string

Obbligatorio. L'ID prodotto definito dal partner.