C# SDK engine

Google Play Games

Игры Google Play: поиск по фразе, категориям, plain search, чарты, highlighted items, секции, устройства магазина и пагинация.

engine: google_play_games constant: XylopSearchEngines.GooglePlayGames GET /search

C# пример

Вызов через XylopSearchClient

using Xylop.Api.Client;

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

using var response = await client.SearchJsonAsync(
    XylopSearchEngines.GooglePlayGames,
    new Dictionary<string, string?>
    {
        ["q"] = "action games",
        ["games_category"] = "GAME_ACTION",
        ["gl"] = "us",
        ["hl"] = "en",
        ["store_device"] = "phone",
    });

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

Endpoint

HTTP контракт

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

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

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

Параметр	Тип	Обязателен	Значение	Описание
`api_key` SDK	string	Да	—	Ключ Xylop API. В C# SDK задается один раз в XylopSearchClientOptions.ApiKey или в конструкторе клиента.
`engine` SDK	string	Да	`google_play_games`	Движок Google Play Games.
`q`	string	Нет	action games	Поисковая фраза. Можно не указывать для plain search или category search.
`games_category`	string	Нет	GAME_ACTION	Категория Google Play Games.
`gl`	string	Нет	`us`	Код страны Google Play.
`hl`	string	Нет	`en`	Язык интерфейса.
`store_device`	string	Нет	`phone`	phone, windows, tablet, tv, chromebook или watch. Не используется вместе с q или games_category.
`chart`	string	Нет	topselling_free	Значение из chart_options для top charts.
`next_page_token`	string	Нет	pagination.next_page_token	Токен следующей страницы.
`section_page_token`	string	Нет	section token	Токен пагинации внутри отдельной секции.
`see_more_token`	string	Нет	see_more_token	Токен раскрытия отдельной секции.

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

Поля ответа

Поле	Тип	Источник	Описание
`search_metadata`	object	пример ответа	Метаданные запроса: статус, идентификатор, время выполнения и служебная информация провайдера.
`search_parameters`	object	пример ответа	Нормализованные параметры, с которыми upstream-поиск выполнил запрос.
`chart_options`	array	пример ответа	Типизированное поле ответа для этого engine; структура зависит от upstream-провайдера и параметров запроса.
`organic_results`	array	пример ответа	Основные органические результаты выдачи: позиции, заголовки, ссылки и сниппеты.
`pagination`	object	пример ответа	Данные пагинации или токены для перехода к следующей странице.

JSON

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

{
  "search_metadata": {
    "status": "Success",
    "google_play_games_url": "https://play.google.com/store/search?q=action+games&c=apps&hl=en&gl=us"
  },
  "search_parameters": {
    "engine": "google_play_games",
    "q": "action games",
    "hl": "en",
    "gl": "us"
  },
  "chart_options": [
    {
      "text": "Top free",
      "value": "topselling_free"
    }
  ],
  "organic_results": [
    {
      "title": "Recommended for you",
      "see_more_token": "...",
      "items": [
        {
          "title": "Subway Surfers",
          "link": "https://play.google.com/store/apps/details?id=com.kiloo.subwaysurf",
          "product_id": "com.kiloo.subwaysurf",
          "rating": 4.6,
          "author": "SYBO Games",
          "category": "Arcade",
          "downloads": "1,000,000,000+",
          "video": "https://play.google.com/video/lava/web/player/...",
          "thumbnail": "https://play-lh.googleusercontent.com/...",
          "description": "Dash as fast as you can."
        }
      ]
    }
  ],
  "pagination": {
    "next_page_token": "EAU..."
  }
}