Method: projects.generateProductTextAttributes

Формирует недостающие атрибуты из информации о продукте.

HTTP-запрос

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

URL использует синтаксис перекодировки gRPC .

Параметры пути

Параметры
parent

string

Обязательно. Проект для совершения звонка. Должен ссылаться на проект звонящего. Формат: projects/{project-id} .

Текст запроса

Тело запроса содержит данные со следующей структурой:

JSON-представление 
{
  "inputAttributes": [
    {
      object (Attribute)
    }
  ],
  "generativeAttributes": [
    {
      object (Attribute)
    }
  ],
  "offerImage": {
    object (Image)
  },
  "clientRequestContext": {
    object (ClientRequestContext)
  },
  "allowAnyConfidenceSuggestions": boolean
}
Поля
inputAttributes[]

object ( Attribute )

Необязательные. Входные атрибуты, используемые для генерации предложений. Поддерживаемые значения: title, description. Эти атрибуты не будут включены в ответ и не изменятся.

generativeAttributes[]

object ( Attribute )

Обязательно. Атрибуты, которые необходимо сгенерировать. Поддерживаются значения: пол, возрастная группа, цвет и размер. Необходимо указать хотя бы одно из этих значений. В ответ будут включены только заданные здесь значения.

offerImage

object ( Image )

Обязательно. Изображение, связанное с продуктом.

clientRequestContext

object ( ClientRequestContext )

Обязательно. Информация о клиенте, подающем запрос.

allowAnyConfidenceSuggestions

boolean

Необязательно. Если задано значение true, в ответ будут включены предложения атрибутов со всеми уровнями достоверности. По умолчанию для всех атрибутов включаются только предложения с высокой степенью достоверности.

Тело ответа

Ответ для projects.generateProductTextAttributes.

В случае успеха тело ответа содержит данные со следующей структурой:

JSON-представление 
{
  "suggestions": [
    {
      object (Attribute)
    }
  ]
}
Поля
suggestions[]

object ( Attribute )

Сгенерированные предложения по атрибутам товара. Это поле может быть пустым, если модель не может предложить атрибуты с достаточной степенью уверенности. Предложения могут включать пол, возрастную группу, цвет и размер в зависимости от атрибутов, которые нужно сгенерировать, в запросе.

Атрибут

Атрибут продукта, который используется в запросе и ответе.

JSON-представление 
{
  "key": string,
  "textValue": string,
  "confidenceLevel": enum (ConfidenceLevel)
}
Поля
key

string

Обязательно. Имя атрибута, предоставленное продавцом.

textValue

string

Необязательно. Сохраняет текстовое значение атрибута. Необходимо задать для inputAttributes в GenerateProductTextAttributesRequest и для suggestions в GenerateProductTextAttributesResponse. На данном этапе используются/генерируются только текстовые атрибуты, поэтому attribute_type (например, INT, RICH_TEXT) и другие format_values (например, float_value, rich_text_value) не определены.

confidenceLevel

enum ( ConfidenceLevel )

Необязательно. Присутствует только в ответе и определяет уровень достоверности сгенерированного предложения атрибута.

Уровень уверенности

Уровень достоверности предложения атрибута, сгенерированного моделью ИИ. Модель выдаёт оценку достоверности для каждого предложения, которое помещается в один из уровней достоверности. Пороги достоверности для каждого сегмента были определены на основе человеческой оценки результатов модели.

Перечисления
CONFIDENCE_LEVEL_UNSPECIFIED Уровень достоверности не указан.
LOW Низкий уровень уверенности.
MEDIUM Средний уровень уверенности.
HIGH Высокий уровень доверия.

ClientRequestContext

Информация о клиенте, подающем запрос.

JSON-представление 
{
  "partnerProductId": string
}
Поля
partnerProductId

string

Обязательно. Идентификатор продукта, указанный партнёром.