C# SDK engine

Google Maps Contributor Reviews

Google Maps reviews written by a specific contributor.

engine: google_maps_contributor_reviews constant: XylopSearchEngines.GoogleMapsContributorReviews GET /search

C# пример

Вызов через XylopSearchClient

using Xylop.Api.Client;

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

using var response = await client.SearchJsonAsync(
    XylopSearchEngines.GoogleMapsContributorReviews,
    new Dictionary<string, string?>
    {
        ["contributor_id"] = "contributor id",
        ["num"] = "10",
    });

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

Endpoint

HTTP контракт

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

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

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

Параметр	Тип	Обязателен	Значение	Описание
`api_key` SDK	string	Да	—	Ключ Xylop API. В C# SDK задается один раз в XylopSearchClientOptions.ApiKey или в конструкторе клиента.
`engine` SDK	string	Да	`google_maps_contributor_reviews`	Google Maps Contributor Reviews engine.
`contributor_id`	string	Да	contributor id	Google Maps contributor id.
`num`	number	Нет	10	Review count.

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

Поля ответа

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

JSON

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

{
  "search_metadata": {
    "status": "Success",
    "google_maps_contributor_reviews_url": "https://www.google.com/maps/contrib/..."
  },
  "contributor": {
    "name": "Example Reviewer"
  },
  "reviews": [
    {
      "position": 1,
      "rating": 5,
      "snippet": "Great coffee.",
      "place": {
        "title": "Example Coffee"
      }
    }
  ]
}