Ефективність за позицією

API + MCP

GET/v3/gsc/performance-by-position

Запити до цього ендпоїнта безкоштовні та не витрачають жодних одиниць API.

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

project_idinteger

Ідентифікатор проєкту. Обов’язковий, якщо portfolio_id не вказано.

portfolio_idinteger

Ідентифікатор портфоліо. Якщо його вказано, агрегує дані за всіма підключеними до GSC проєктами в межах портфоліо.

date_fromstring (date)Обов’язково

Дата початку історичного періоду у форматі YYYY-MM-DD.

date_tostring (date)

Дата завершення історичного періоду у форматі YYYY-MM-DD.

search_typestring

Тип результатів пошуку для повернення (web, image, video, news).

Дозволені значення:webimagevideonews

За Замовчуванням:web

countrystring

Двобуквений код країни (ISO 3166-1 alpha-2).

Дозволені значення:adaeafagaialamaoarasatauawazba…

devicestring

Фільтрування за типом пристрою (DESKTOP, MOBILE, TABLET). Якщо не вказано, буде включено всі пристрої.

Дозволені значення:desktopmobiletablet

wherestring

Підтримувані поля:

outputstring

Формат виводу.

Дозволені значення:jsoncsvxmlphp

Відповіді

metricsarray<object>

clicksinteger

clicks_percentnumber (float)

impressionsinteger

impressions_percentnumber (float)

keyword_countinteger

keyword_count_percentnumber (float)

position_rangestring

{ "metrics": [ { "clicks": 0, "clicks_percent": 0.0, "impressions": 0, "impressions_percent": 0.0, "keyword_count": 0, "keyword_count_percent": 0.0, "position_range": "string" } ] }