Bu rehberde: YouTube kanalınızı bağlarsınız. Google Cloud'daki OAuth istemcisi Google Analytics, Search Console ve Sheets ile paylaşılır. Günlük kotayı (günde ~6 video) ve doğrulama gereklerini öğrenirsiniz.
⏱ 25 dakika
Kimlik kartı
| Alan | Değer |
|---|---|
| Sağlayıcı anahtarı | YOUTUBE |
| Kategori | Sosyal medya |
| Kimlik doğrulama | İzin ekranı (Google) |
| Kapsam | Proje bazlı |
| Webhook | Hayır |
| Yetenekler | Video yayınlama, metrik okuma, yorum okuma, yorum yanıtlama |
| Kullanan kutular | Yayınla, Zamanla, Metrik al, Yorumları al, Yanıtla |
| Kullanan ajanlar | Content Creator (başlık/açıklama), Social Publisher, Community Manager |
Ne işe yarar?
Kanalınıza video yükler (başlık, açıklama, etiketler, gizlilik); izlenme, süre, abone ve etkileşim okur; yorumları çekip yanıtlar.
Ön koşullar
- Bir YouTube kanalı ve kanal sahibi Google hesabı. Marka Hesabı kullanıyorsanız yetkilendirmede o kanalı seçin.
- Platform yöneticisinin
GOOGLE_CLIENT_IDveGOOGLE_CLIENT_SECRETtanımlamış olması. Aynı istemci GA4, Search Console ve Sheets için de kullanılır. - Herkese açık video yükleme için Google OAuth uygulama doğrulaması.
Adım adım kurulum
A) Google Cloud Console (platform yöneticisi)
- console.cloud.google.com → proje seçin veya oluşturun.
- APIs & Services → Library: ① YouTube Data API v3 ve ② YouTube Analytics API → Enable. Aynı projede GA4, Search Console ve Sheets API'leri de etkinleştirilebilir.
- Google Auth Platform → Branding: uygulama adı, destek e-postası, logo, gizlilik politikası, yetkili alan adları.
- ③ Audience: External. Testing durumunda en fazla 100 test kullanıcısı ve 7 günde dolan izin. Canlı için Publish app → In production.
- ① Data Access → Add or remove scopes:
youtube.upload,youtube.readonly,youtube.force-ssl,yt-analytics.readonly→ Update → Save. - ②
youtube.uploadhassas kapsamdır; production için doğrulama başvurusu (3-7 iş günü).
- Clients → Create client → Web application. ① Client ID ve ② Client secret değerlerini kopyalayın.
- ① Authorized redirect URIs:
https://api.orqlabs.com/api/v1/integrations/oauth/youtube/callback. Aynı istemciyi paylaşan diğer Google sağlayıcıları için de ekleyin:…/oauth/google_analytics/callback,…/oauth/google_search_console/callback,…/oauth/google_sheets/callback. ② Authorized JavaScript origins:https://app.orqlabs.com. ③ Save. - Yönetici değerleri
GOOGLE_CLIENT_IDveGOOGLE_CLIENT_SECRETolarak tanımlar.
B) OrqLabs'ta bağlama
- Entegrasyonlar → YouTube → Bağla.
- ① Proje seçin; ② Bağla.
- Google hesap seçiminde kanalın sahibi hesabı veya Marka Hesabını seçin. Doğrulanmamış uygulamada "Google hasn't verified this app" uyarısı çıkar → Advanced → Go to .
- İzinleri onaylayın; geri dönüşte kanal listesinden birini seçin.
- Bağlantıyı test et: kanal adı, abone ve video sayısı görünmelidir.
İzinler ve kapsamlar
| Kapsam | Neden gerekli |
|---|---|
https://www.googleapis.com/auth/youtube.upload | Video yükleme |
https://www.googleapis.com/auth/youtube.readonly | Kanal, video listesi, yorumları okuma |
https://www.googleapis.com/auth/youtube.force-ssl | Yorumlara yanıt yazma |
https://www.googleapis.com/auth/yt-analytics.readonly | İzlenme, süre, abone raporları |
Uygulama incelemesi
- Testing durumunda yalnızca test kullanıcıları bağlanır; izin 7 günde düşer.
- Doğrulanmamış uygulamadan yüklenen videolar YouTube tarafından private kilitlenir ve herkese açık yapılamaz. Canlı yayın için hem OAuth doğrulaması hem YouTube API Services compliance audit gerekir.
- Kota artırımı da aynı denetim formundan istenir.
Limitler
| Konu | Sınır |
|---|---|
| Günlük kota | Proje başına 10.000 birim/gün |
| Yükleme maliyeti | 1.600 birim → günde en fazla 6 yükleme |
| Başlık | 100 karakter |
| Açıklama | 5.000 karakter; hashtag 15 |
| Video | 256 GB / 12 saat (doğrulanmış hesap), 15 dk (doğrulanmamış) |
| Medya | Yalnızca video |
| Analitik | 2-3 gün gecikmeli |
Bağlantıyı test etme
② Bağlantıyı test et kanal bilgisini okur (1 birim). İlk yükleme için test modunda Yayınla kutusuyla başlık ve video adresini doğrulayın; sonra gizliliği private bir videoyla gerçek yükleme deneyin.
Kimlik bilgilerini yenileme
- Production'da izin süresizdir; kullanıcı Google Hesabı → Güvenlik → Üçüncü taraf erişimi üzerinden kaldırırsa veya 6 ay kullanılmazsa düşer → Yeniden yetkilendir.
- Testing'de 7 günlük düşüş normaldir; uygulamayı production'a alın.
- Client secret döndürülürse tüm Google bağlantıları yeniden yetkilendirilir.
Sık karşılaşılan hatalar
| Hata | Olası neden | Çözüm |
|---|---|---|
| "redirect_uri_mismatch" | Adres kayıtlı değil | Tam adresi ekleyin |
| "access_denied" / "app is being tested" | Test listesinde değil | Test users'a ekleyin veya production |
AUTH – invalid_grant | İzin dolmuş (Testing 7 gün) | Yeniden yetkilendir; production'a alın |
RATE_LIMIT – quotaExceeded | 10.000 birim tükendi | Ertesi güne bekleyin; kota artırımı |
INVALID – uploadLimitExceeded | Kanal günlük yükleme sınırı | Kanal doğrulaması |
| Video "private (locked)" | Uygulama doğrulanmamış | OAuth doğrulaması + API denetimi |
INVALID – invalidTitle | Başlık 100'den uzun veya yasak karakter | Content Creator'a sınır belirtin |
| Analitik boş | Kanal sahibi değil veya gecikme | Kanal sahibiyle bağlanın; 3 gün bekleyin |
Sık sorulan sorular
Günde kaç video yükleyebilirim? Kota 10.000 birim; bir yükleme 1.600 birim. Diğer çağrılarla birlikte günde yaklaşık 6.
Video neden özel kaldı? Uygulama doğrulanmamış. Google doğrulaması ve YouTube denetimi tamamlanmadan videolar herkese açık yapılamaz.
Aynı Google istemcisini Analytics için de kullanabilir miyim? Evet. Tek istemci dört Google sağlayıcısına hizmet eder; yalnızca geri dönüş adreslerini ekleyin.