YouTube

Offline access ile Google OAuth 2.0. Auth URL refresh-token verilmesini zorlamak için access_type=offline ve prompt=consent geçer.

Kimlik bir bakışta

Alan	Değer
Kimlik modeli	OAuth 2.0
Gerekli ENV	YOUTUBE_CLIENT_ID, YOUTUBE_CLIENT_SECRET
Callback URL	${BASE_URL}/api/v1/auth/youtube/callback
Scope'lar / izinler	https://www.googleapis.com/auth/youtube.upload, https://www.googleapis.com/auth/youtube.readonly
Otomatik token yenileme	Evet — süresi dolmadan 7 gün önce

Nasıl bağlanılır

1. Bağlantılar → YouTube → Bağlan'ı aç.
2. Google'a giriş yap ve youtube.upload ve youtube.readonly'i onayla.
3. Sosyabot keşfedilen her YouTube kanalı için bir kanal kayıdı oluşturur.

Token yenileme

Otomatik yenilenir. Varsayılan access-token TTL'i 1 saat'tir. tokenRefresh.queue.ts worker'ı, gönderiler çalışmadan önce yeni access token'lar üretmek için saklanan refresh_token'ı kullanır.

Notlar

• OAuth onayı birden fazla YouTube kanalı dönerse, Sosyabot YouTube kanalı başına bir Sosyabot kanalı oluşturur. Bağlantı callback'i youtube.channels.list'i iterate eder ve her birini saklar.
• YouTube Data API v3 günlük kotası varsayılan olarak 10000 birimdir. Her video yükleme 1600 birim harcar — varsayılan kotada günde ~6 yükleme demektir. Production hacmi için Google'dan kota artırımı talep et.
• Token kayıdı channelId ve channelTitle saklar; thumbnail URL'leri bağlantılar listesi UI'sı için data'da önbelleğe alınır.

Sorun giderme

Kanal needs_reconnect gösteriyorsa, access token YouTube tarafından reddedilmiştir. Yaygın sebepler:

• Kullanıcı Sosyabot'un yetkilendirmesini platform üzerinden iptal etmiştir.
• Platform token'ı geçersiz kılmıştır (şifre değişikliği, güvenlik olayı).
• OAuth uygulama kimlik bilgileriniz değişmiştir ve mevcut token'lar artık eşleşmiyordur.

Yukarıdaki bağlantı akışını yeniden çalıştır. Çalışma alanı genelinde checklist için Sorun Giderme'ye bak.

İlgili

Bağlantılar Genel Bakış

Editör

OAuth Callback URL'leri