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.
Gdzie to znajdziesz
Na liście Rodzaj wybierz api/youtube_analytics - lista pokazuje techniczne nazwy rodzajów,
nie etykiety.
Co trzeba przygotować
- Projekt w Google Cloud z włączonymi dwoma API: YouTube Analytics API i YouTube Data API v3.
-
Dane aplikacji OAuth z tego projektu:
client_idiclient_secret. -
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
- „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_idwskazuje 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.