Method: projects.generateProductTextAttributes

Generiert fehlende Attribute aus Produktinformationen.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Projekt zum Anrufen. Muss sich auf das Projekt eines Anrufers beziehen. Format: projects/{project-id}.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

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

object (Attribute)

Optional. Die Eingabeattribute, die zum Generieren der Vorschläge verwendet werden. Die unterstützten Werte sind „title“ und „description“. Diese Attribute sind nicht in der Antwort enthalten und werden nicht geändert.
generativeAttributes[]

object (Attribute)

Erforderlich. Zu generierende Attribute. Die unterstützten Werte sind „Geschlecht“ [gender], „Altersgruppe“ [age_group], „Farbe“ [color] und „Größe“ [size]. Mindestens einer dieser Werte muss festgelegt sein. Nur die hier festgelegten Werte werden in die Antwort aufgenommen.
offerImage

object (Image)

Erforderlich. Das dem Produkt zugeordnete Bild.
clientRequestContext

object (ClientRequestContext)

Erforderlich. Informationen zum Client, der die Anfrage stellt.
allowAnyConfidenceSuggestions

boolean

Optional. Bei „true“ werden Attributvorschläge mit allen Konfidenzniveaus in die Antwort aufgenommen. Standardmäßig sind für alle Attribute nur Vorschläge mit hoher Wahrscheinlichkeit enthalten.

Antworttext

Antwort für „projects.generateProductTextAttributes“.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "suggestions": [
    {
      object (Attribute)
    }
  ]
}
Felder
suggestions[]

object (Attribute)

Die generierten Vorschläge für Produktattribute. Dieses Feld kann leer sein, wenn das Modell keine Attribute mit ausreichend hohen Konfidenzwerten vorschlagen kann. Die Vorschläge können je nach den „attributes_to_generate“ in der Anfrage Geschlecht, Altersgruppe, Farbe und Größe umfassen.

Attribut

Ein Produktattribut, das in der Anfrage und Antwort verwendet wird.

JSON-Darstellung 
{
  "key": string,
  "textValue": string,
  "confidenceLevel": enum (ConfidenceLevel)
}
Felder
key

string

Erforderlich. Vom Händler angegebener Attributname.
textValue

string

Optional. Speichert den Textwert des Attributs. Dieser Wert muss für „inputAttributes“ in „GenerateProductTextAttributesRequest“ und für Vorschläge in „GenerateProductTextAttributesResponse“ festgelegt werden. Zu diesem Zeitpunkt werden nur Textattribute verwendet/generiert. Daher sind attribute_type(z. B. INT, RICH_TEXT) und andere format_values(z. B. float_value, rich_text_value) nicht definiert.
confidenceLevel

enum (ConfidenceLevel)

Optional. Dieser Wert ist nur in der Antwort vorhanden und bestimmt das Konfidenzniveau des generierten Attributvorschlags.

ConfidenceLevel

Das Konfidenzniveau des vom KI-Modell generierten Attributvorschlags. Das Modell gibt für jeden Vorschlag einen Konfidenzwert aus, der in eine der Konfidenzstufen eingeordnet wird. Die Konfidenzgrenzwerte für die einzelnen Kategorien wurden auf Grundlage von manuellen Bewertungen der Modellausgaben festgelegt.

Enums
CONFIDENCE_LEVEL_UNSPECIFIED Konfidenzniveau nicht angegeben.
LOW Niedriges Konfidenzniveau.
MEDIUM Mittleres Konfidenzniveau.
HIGH Hohes Konfidenzniveau.

ClientRequestContext

Informationen zum Client, der die Anfrage stellt.

JSON-Darstellung 
{
  "partnerProductId": string
}
Felder
partnerProductId

string

Erforderlich. Die vom Partner definierte Produkt-ID.