Method: projects.generateProductText

Genera un insieme di completamenti/risposte di testo candidati a partire dalle informazioni sul prodotto.

Richiesta HTTP

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

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

object (TitleExample)

(Facoltativo) Fornisci alcuni esempi artigianali di miglioramenti dei titoli unici per il tuo caso d'uso. TiDe è uno strumento generico che gestisce più categorie di prodotti, ma l'identità del tuo brand potrebbe richiedere funzionalità personalizzate. Puoi specificarlo qui.
productInfo

object (ProductInfo)

Obbligatorio. Informazioni disponibili sul prodotto. Utilizzati per informare i modelli di AI generativa.
outputSpec

object (OutputSpec)

(Facoltativo) Parametri di configurazione che influiscono direttamente sui contenuti generati e sul modo in cui vengono visualizzati nella risposta finale.

Corpo della risposta

Testo generato per un prodotto fornito.

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

Rappresentazione JSON 
{
  "attributes": {
    string: string,
    ...
  },
  "title": {
    object (ProductTextGenerationSuggestion)
  },
  "description": {
    object (ProductTextGenerationSuggestion)
  },
  "metadata": {
    object (ProductTextGenerationMetadata)
  }
}
Campi
attributes

map (key: string, value: string)

Qualsiasi altro attributo generato

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
title

object (ProductTextGenerationSuggestion)

Titolo generato.
description

object (ProductTextGenerationSuggestion)

Descrizione generata.
metadata

object (ProductTextGenerationMetadata)

Informazioni aggiuntive che i client potrebbero voler controllare in merito alla generazione.

ProductInfo

Informazioni disponibili sul prodotto. Utilizzati per informare i modelli di AI generativa.

Rappresentazione JSON 
{
  "productAttributes": {
    string: string,
    ...
  },
  "productImage": {
    object (Image)
  }
}
Campi
productAttributes

map (key: string, value: string)

Obbligatorio. Un mapping di tutti gli attributi di prodotto disponibili. Queste possono includere titolo, descrizione, marca, genere, colore, taglia e così via.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
productImage

object (Image)

(Facoltativo) Immagine associata al prodotto.

OutputSpec

Parametri di configurazione che influiscono direttamente sui contenuti generati e sul modo in cui vengono visualizzati nella risposta finale.

Rappresentazione JSON 
{
  "workflowId": string,
  "tone": string,
  "editorialChanges": string
}
Campi
workflowId

string

(Facoltativo) Il flusso di lavoro da eseguire per i dati di prodotto forniti. I flussi di lavoro possono compilare il titolo, la descrizione o entrambi della risposta.
tone

string

(Facoltativo) Il tono di output desiderato per il testo generato. Ad esempio, serio, informale.
editorialChanges

string

(Facoltativo) Eventuali modifiche redazionali ai dati di prodotto generati. Ad esempio, sostituisci Small con "S", non modificare il colore se è già presente.

TitleExample

Un esempio artigianale di miglioramento del titolo del prodotto. Questi esempi vengono forniti all'AI per migliorarne la qualità.

Rappresentazione JSON 
{
  "productInfo": {
    string: string,
    ...
  },
  "finalProductInfo": {
    string: string,
    ...
  },
  "titleFormat": string,
  "category": string
}
Campi
productInfo

map (key: string, value: string)

Obbligatorio. Una mappa contenente tutte le informazioni sui prodotti esistenti. Ad es. {"title": "vestito", "description": "Un vestito rosso", "brand": "Dresses4All"} Qualsiasi informazione che potresti utilizzare per compilare il feed dei prodotti.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
finalProductInfo

map (key: string, value: string)

Obbligatorio. Una mappa nello stesso formato di productInfo, ma con tutti i miglioramenti inclusi. Ad esempio: {"brand": "Dresses4All", "product": "dress", "color": "red", ...} Per ora, ordina questi attributi nell'ordine in cui vuoi che vengano visualizzati nel titolo finale. Ad es. il titolo precedente diventerà: Dresses4All dress | red

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
titleFormat

string

Obbligatorio. Gli attributi o gli attributi approssimativi che compongono il titolo. Ad esempio, il titolo "Google GShoe M" titleFormat può essere "brand | product | size".
category

string

Obbligatorio. La categoria del prodotto. In questo modo, l'AI può capire quando alcuni esempi sono più pertinenti di altri.

ProductTextGenerationSuggestion

Testo generato per un prodotto, che include facoltativamente il punteggio di qualità.

Rappresentazione JSON 
{
  "text": string,
  "score": number,
  "changeSummary": string
}
Campi
text

string

Il testo generato
score

number

Il punteggio di qualità associato alla generazione. Euristiche implementate in base agli stili di implementazione del team di feedgen.
changeSummary

string

Un breve riepilogo di tutte le modifiche apportate.

ProductTextGenerationMetadata

Tipo di dati wrapper per tutti i metadati associati alla generazione di testo.

Rappresentazione JSON 
{
  "metadata": {
    object
  }
}
Campi
metadata

object (Struct format)

I metadati sono un concetto piuttosto ampio. I dati sono modellati come una mappa per indicare che non esiste una struttura garantita per l'output oltre a una semplice associazione chiave-valore. Il primo caso d'uso consiste nel monitorare le parole aggiunte, rimosse o modificate nelle generazioni.