Method: projects.generateProductTextAttributes

Generuje brakujące atrybuty na podstawie informacji o produkcie.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

Wymagany. wyświetlić projekt, aby zadzwonić; Musi odnosić się do projektu wywołującego. Format: projects/{project-id}.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

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

object (Attribute)

Opcjonalnie. Atrybuty wejściowe użyte do wygenerowania sugestii. Obsługiwane wartości to: title, description. Te atrybuty nie zostaną uwzględnione w odpowiedzi i nie ulegną zmianie.
generativeAttributes[]

object (Attribute)

Wymagany. Atrybuty do wygenerowania. Obsługiwane wartości to płeć, grupa_wiekowa, kolor i rozmiar. Należy ustawić co najmniej jedną z tych wartości. W odpowiedzi będą uwzględniane tylko wartości ustawione tutaj.
offerImage

object (Image)

Wymagany. Obraz powiązany z produktem.
clientRequestContext

object (ClientRequestContext)

Wymagany. Informacje o kliencie, który wysłał żądanie.
allowAnyConfidenceSuggestions

boolean

Opcjonalnie. Jeśli ma wartość true, w odpowiedzi zostaną uwzględnione sugestie atrybutów ze wszystkimi poziomami ufności. Domyślnie w przypadku wszystkich atrybutów uwzględniane są tylko sugestie o wysokim stopniu pewności.

Treść odpowiedzi

Odpowiedź na żądanie projects.generateProductTextAttributes.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "suggestions": [
    {
      object (Attribute)
    }
  ]
}
Pola
suggestions[]

object (Attribute)

Wygenerowane sugestie atrybutów produktu. Może być pusta, jeśli model nie może zaproponować atrybutów z wystarczająco wysokimi wskaźnikami ufności. Sugestie mogą dotyczyć płci, grupy wiekowej, koloru i rozmiaru na podstawie atrybutów do wygenerowania w żądaniu.

Atrybut

Atrybut produktu używany w żądaniu i odpowiedzi.

Zapis JSON 
{
  "key": string,
  "textValue": string,
  "confidenceLevel": enum (ConfidenceLevel)
}
Pola
key

string

Wymagany. Nazwa atrybutu podana przez sprzedawcę.
textValue

string

Opcjonalnie. Przechowuje wartość tekstową atrybutu. Musi być ustawiony w przypadku atrybutu inputAttributes w GenerateProductTextAttributesRequest i w przypadku sugestii w GenerateProductTextAttributesResponse. W tym momencie używane/generowane są tylko atrybuty tekstowe, więc atrybut_type(np. INT, RICH_TEXT) i inne format_values(np. float_value, rich_text_value) nie są zdefiniowane.
confidenceLevel

enum (ConfidenceLevel)

Opcjonalnie. Ten parametr występuje tylko w odpowiedzi i określa poziom ufności wygenerowanej sugestii atrybutu.

ConfidenceLevel

Poziom ufności sugestii atrybutu wygenerowanej przez model AI. Model zwraca wskaźnik ufności dla każdej sugestii, który jest przypisywany do jednego z poziomów ufności. Wartości progowe ufności dla poszczególnych koszyków zostały określone na podstawie ocen danych wyjściowych modelu przez weryfikatorów.

Wartości w polu enum
CONFIDENCE_LEVEL_UNSPECIFIED Nieokreślony poziom ufności.
LOW Niski poziom ufności.
MEDIUM Średni poziom ufności.
HIGH Wysoki poziom ufności.

ClientRequestContext

Informacje o kliencie, który wysłał żądanie.

Zapis JSON 
{
  "partnerProductId": string
}
Pola
partnerProductId

string

Wymagany. Identyfikator produktu zdefiniowany przez partnera.