Grupy fraz w projekcie (getMyGroupsInProject)
/api/rank_tracker/management/projects/getMyGroupsInProjectZwraca grupy fraz zdefiniowane w projekcie wraz z liczbą fraz w każdej z nich. Identyfikatory grup podaje się dalej jako group_id w raportach Monitoringu — to najprostsza droga, by przejść od projektu do konkretnego wycinka fraz.
Żądanie
GET /api/rank_tracker/management/projects/getMyGroupsInProject
Nagłówki: Authorization: Bearer <token>.
Parametry przekazuje się w query stringu.
Żądanie
{
"project_id": null
}Parametry
| Name | Type | Default |
|---|---|---|
project_id | numberWymagane w praktyce. Identyfikator projektu; brak parametru jest interpretowany jako |
Typ pola count jest niespójny. Wiersz zbiorczy (id: 0) ma liczbę, a grupy rzeczywiste — string ("1"). Rzutuj na liczbę przed obliczeniami.
Pierwszy wiersz odpowiedzi jest syntetyczny: id: 0 z nazwą „Słowa kluczowe projektu” i sumą fraz ze wszystkich grup. Nie jest to istniejąca grupa — nie przekazuj 0 jako group_id, jeśli chcesz konkretną grupę.
Endpoint zwraca wyłącznie grupy niedynamiczne należące do Twojego konta w tym projekcie. Brak project_id w query nie jest błędem — zwróci pustą listę z samym wierszem zbiorczym.
Odpowiedź
Przykład to rzeczywista odpowiedź produkcyjna, skrócona.
{
"success": true,
"data": [
{
"id": 0,
"name": "Słowa kluczowe projektu",
"count": 342
},
{
"id": 12345,
"name": "Kategorie produktowe",
"count": "128"
}
]
}Struktura odpowiedzi
Błędy
Błędy tego endpointu przychodzą we wspólnej kopercie ze statusem 418.
Powiązane akcje
getMyActiveProjects— skąd wziąćproject_id.keywords/getGroupKeywords— frazy w wskazanej grupie.groups/list— grupy z pełnymi danymi.