[Intum Pomoc](https://intum.pl/pomoc.md) / [Konektory](https://intum.pl/pomoc/noe/konektory.md)

# [Statystyki YouTube](https://intum.pl/pomoc/noe/noe-youtube.md)

Konektor daje agentowi AI wgląd w statystyki Twojego kanału na YouTube. Agent może z nich
zrobić cotygodniowe podsumowanie, porównać filmy między sobą albo dopisać wnioski do zadania -
zamiast tego, żeby ktoś raz w tygodniu przepisywał liczby ze Studia YouTube.

Liczby są te same, które widzisz w YouTube Studio, łącznie z tymi, których nie da się wyciągnąć
publicznie: **CTR miniatury**, **liczba wyświetleń miniatury** i **procent obejrzanego materiału**.
Dlatego konektor wymaga zgody właściciela kanału, a nie zwykłego klucza API.

> [!PATH]
> [Connect → Konektory](app:/connect/connectors) → **Nowy konektor**

Na liście **Rodzaj** wybierz `api/youtube_analytics` - lista pokazuje techniczne nazwy rodzajów,
nie etykiety.

## Co trzeba przygotować

1. **Projekt w Google Cloud** z włączonymi dwoma API: *YouTube Analytics API* i *YouTube Data API v3*.
2. **Dane aplikacji OAuth** z tego projektu: `client_id` i `client_secret`.
3. **Refresh token** właściciela kanału, wystawiony na dwa zakresy:
   - `https://www.googleapis.com/auth/yt-analytics.readonly`,
   - `https://www.googleapis.com/auth/youtube.readonly`.

Refresh token zdobywa się raz, jednorazową zgodą w oknie Google. Jeśli nie wiesz, jak to
zrobić, poproś administratora albo agenta AI - to kilka minut pracy w konsoli Google Cloud.

## Dodanie konektora

Na formatce konektora wypełnij:

- **channel_id** - identyfikator kanału (zaczyna się od `UC...`). Zostaw puste, jeśli token
  należy do właściciela tego jednego kanału - raport pójdzie wtedy na jego kanał,
- **client_id**, **client_secret** - z aplikacji OAuth. Puste = konektor użyje wspólnej
  aplikacji Google skonfigurowanej na serwerze,
- **refresh_token** - token właściciela kanału.

Po zapisaniu wejdź na ekran konektora - w spisie metod przy `check` kliknij **execute**.
Konektor odpyta YouTube o jeden dzień i powie, czy poświadczenia działają.

**Jeden konektor = jeden kanał.** Dwie marki na dwóch kanałach to dwa konektory z własnymi
poświadczeniami.

## O co można poprosić agenta

| Pytanie do agenta | Co dostaniesz |
|---|---|
| „Podsumuj ostatni miesiąc na kanale" | wyświetlenia, czas oglądania, średni czas seansu, przyrost i spadek subskrypcji |
| „Jak poszedł film X?" | to samo dla jednego filmu, plus retencja, wyświetlenia miniatury i CTR |
| „Które filmy ciągnęły ruch w lutym?" | lista najczęściej oglądanych filmów z tytułami (domyślnie 10, maksymalnie 50) |

Bez podania dat raport obejmuje **ostatnie 28 dni skończone na wczoraj**. To nie pomyłka:
YouTube domyka dane z opóźnieniem, więc dzisiejszy dzień zawsze wyglądałby na nagły spadek
oglądalności.

## Kiedy coś nie działa {#kiedy-nie-dziala}

- **„autoryzacja wygasła - połącz kanał na nowo"** - Google odrzucił refresh token. Najczęściej
  po cofnięciu dostępu aplikacji, zmianie hasła albo usunięciu konta z kanału. Konektor
  **wyłącza się wtedy sam**, żeby nie dobijać się do Google przy każdym pytaniu agenta.
  Wystaw nowy refresh token, wklej go i włącz konektor z powrotem.
- **„brak client_id/client_secret"** - ani konektor, ani serwer nie mają danych aplikacji OAuth.
- **Raport z zerami** - sprawdź, czy `channel_id` wskazuje właściwy kanał i czy konto, z którego
  wystawiono token, ma do niego dostęp.

## Czego konektor nie robi

Tylko czyta. Nie wrzuca filmów, nie zmienia tytułów, opisów ani miniatur, nie odpowiada na
komentarze. Nie ma też przycisku „połącz kanał" - refresh token wkleja się ręcznie.