C# SDK engine

Google Ads

Google sponsored results from the Ads API.

engine: google_ads constant: XylopSearchEngines.GoogleAds GET /search

C# пример

Вызов через XylopSearchClient

using Xylop.Api.Client;

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

using var response = await client.SearchJsonAsync(
    XylopSearchEngines.GoogleAds,
    new Dictionary<string, string?>
    {
        ["q"] = "popular ai",
        ["location"] = "Austin, Texas, United States",
    });

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

Endpoint

HTTP контракт

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

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

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

Параметр	Тип	Обязателен	Значение	Описание
`api_key` SDK	string	Да	—	Ключ Xylop API. В C# SDK задается один раз в XylopSearchClientOptions.ApiKey или в конструкторе клиента.
`engine` SDK	string	Да	`google_ads`	Google Ads engine.
`q`	string	Да	popular ai	Ad search query.
`location`	string	Да	Austin, Texas, United States	Search location.

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

Поля ответа

Поле	Тип	Источник	Описание
`search_metadata`	object	пример ответа	Метаданные запроса: статус, идентификатор, время выполнения и служебная информация провайдера.
`ads`	array	пример ответа	Рекламные результаты, если выбранный engine и запрос их возвращают.

JSON

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

{
  "search_metadata": { "status": "Success" },
  "ads": [
    {
      "position": 1,
      "title": "Example Ad",
      "link": "https://example.com"
    }
  ]
}