C# SDK engine

Google Product

Google Product typed metadata/error contract for legacy product id lookups.

engine: google_product constant: XylopSearchEngines.GoogleProduct GET /search

C# пример

Вызов через XylopSearchClient

using Xylop.Api.Client;

var client = new XylopSearchClient(new HttpClient(), "YOUR_API_KEY");

using var response = await client.SearchJsonAsync(
    XylopSearchEngines.GoogleProduct,
    new Dictionary<string, string?>
    {
        ["product_id"] = "product id",
        ["gl"] = "us",
        ["hl"] = "en",
    });

Для типизированного режима используйте `SearchAsync<TResponse>` и response-модель из `Xylop.Logic.SerpApiResponses.*`, которая входит в пакет C# SDK.

Endpoint

HTTP контракт

URL: https://api.xylop.ru/search
Engine: google_product
API key: Передается SDK автоматически из настроек клиента.

Входные параметры

Параметры запроса

Параметр	Тип	Обязателен	Значение	Описание
`api_key` SDK	string	Да	—	Ключ Xylop API. В C# SDK задается один раз в XylopSearchClientOptions.ApiKey или в конструкторе клиента.
`engine` SDK	string	Да	`google_product`	Google Product engine.
`product_id`	string	Да	product id	Google product id.
`gl`	string	Нет	`us`	Country code.
`hl`	string	Нет	`en`	Interface language.

Выходные параметры

Поля ответа

Поле	Тип	Источник	Описание
`search_metadata`	object	пример ответа	Метаданные запроса: статус, идентификатор, время выполнения и служебная информация провайдера.
`search_parameters`	object	пример ответа	Нормализованные параметры, с которыми upstream-поиск выполнил запрос.
`product_results`	object	пример ответа	Товары, цены, продавцы, рейтинги и ссылки на карточки.

JSON

Пример ответа

{
  "search_metadata": {
    "status": "Success",
    "google_product_url": "https://www.google.com/shopping/product/..."
  },
  "search_parameters": {
    "engine": "google_product",
    "product_id": "123"
  },
  "product_results": {
    "title": "Example Product",
    "product_id": "123"
  }
}