Canlı sohbet oyunları için YouTube API anahtarı: kurulum ve günlük kota

Bir canlı sohbet oyunu, yayınının sohbetini mesaj mesaj okumak zorundadır. YouTube bunu YouTube Data API v3 ile sunar ve onu kullanan her program kendini bir API anahtarı ile tanıtır. Anahtar ücretsizdir. Senindir, sahibi olduğun bir Google Cloud projesine bağlıdır ve istediğin an silebilirsin.

Gerekli mi?

Yalnızca izleyicilerin oynamasını istiyorsan. FlagsBattle anahtar olmadan da çalışır ve yayınlanır: rauntlar, modlar, arenalar, spiker ve zafer müzikleri kendi başına çalışır. Anahtar, canlı sohbetini oyuna bağlar. Anahtarla, izleyicinin gönderdiği her bayrak emojisi o raunt için ülkesine +1 destek verir ve destekler kalkan kazandırır: 10 destek 1 kalkan, 50 destek 2, 100 destek 3, 500 destek 5 kalkan getirir. Kalkan, boşluktan düşen bayrağı kurtarır. Destekler ve kalkanlar her rauntta sıfırdan başlar.

Anahtarı oluştur (yaklaşık beş dakika)

1. Google Cloud Console'u aç ve Google hesabınla giriş yap. Bir proje oluştur; adı önemli değil ("FlagsBattle" olur). Sayfanın üstünde yeni projenin seçili olduğunu kontrol et.
2. API Kitaplığı'nı aç, YouTube Data API v3'ü seç ve Etkinleştir'e tıkla.
3. Kimlik bilgileri'ne git, Kimlik bilgisi oluştur'a tıkla ve API anahtarı'nı seç. Anahtarı kopyala: AIza ile başlayan uzun bir harf ve rakam dizisidir.
4. Önerilir: anahtarı aç, API kısıtlamaları altında Anahtarı kısıtla'yı seç ve yalnızca YouTube Data API v3'ü işaretle. Kısıtlı bir anahtar, sızsa bile başka hiçbir işe yaramaz.

Bunun için kredi kartı gerekmez. Her projeye verilen ücretsiz günlük kotayı kullanıyorsun.

Oyuna gir

FlagsBattle'da sağ paneldeki Araçlar bölümünden YouTube API'yi (anahtar simgesi) aç. Anahtarı kutuya yapıştır; birden fazla anahtarın varsa her satıra bir tane yaz. Kaydet ve uygula'ya, ardından Bağlantıyı test et'e tıkla. Oyun anahtarı hatırlar. Test YouTube'a küçük bir istek gönderir ve bulduğunu söyler:

• Çalışıyor: hazırsın. Yayına çıktığında yayının linkini sol paneldeki Sohbet seçeneğinin altındaki kutuya yapıştır ve Bağlan'a tıkla (yayıncı rehberine bak).
• Geçersiz: anahtar eksik ya da fazla bir karakterle kopyalanmış. Kimlik bilgileri sayfasından yeniden kopyala.
• YouTube Data API v3 etkin değil: anahtar, 2. adımı atladığın bir projeye ait ya da konsolda başka bir proje seçili.
• Başka API'lere kısıtlanmış: anahtarın API kısıtlamalarına YouTube Data API v3'ü ekle.
• Kota doldu: anahtar çalışıyor ama bugünkü hak bitmiş. Aşağıya bak.

Günlük kota nasıl işler?

Google, YouTube Data API için her projeye günlük bir kota verir; yeni bir projede varsayılan değer günde 10.000 birimdir. Bir oyun YouTube'a "yeni sohbet mesajı var mı?" diye her sorduğunda bu haktan bir kısmını harcar. Canlı sohbet oyunu yayında olduğun sürece birkaç saniyede bir sormak zorundadır; yani kota izleyici sayısına göre değil, yayında geçen süreye göre harcanır. Varsayılan kota, kabaca bir saatlik canlı sohbete yeter.

Bilmeye değer iki ayrıntı:

• Kota Pasifik saatiyle gece yarısı sıfırlanır (Türkiye saatiyle yazın 10:00, kışın 11:00). Geç saatteki bir yayında kota biterse, senin gece yarında değil ertesi gün o saatte geri gelir.
• Sessiz sohbet de kalabalık sohbet kadar harcar. Oyun her iki durumda da mesaj sorar. Mola verirken Bağlantıyı kes'e tıklamak ya da Sohbet'i kapatmak okumayı durdurur ve kota kazandırır.

Günde bir saatten fazlası mı lazım?

İki yol var ve ikisi eşit değil.

Google'dan daha yüksek kota iste (güvenli yol). Cloud Console'da YouTube, YouTube API Hizmetleri için bir denetim ve kota artırma formu sunar. Uygulamanın ne yaptığını (bir oyunu yönetmek için kendi yayınının herkese açık sohbetini okumak) ve kaç birime ihtiyacın olduğunu anlatırsın. Dürüst ve net yanıt ver; onay zaman alabilir, ihtiyaç duymadan önce iste.

Birden fazla anahtar. YouTube API penceresi birden fazla anahtar kabul eder, her satıra bir tane. Yayın sırasında bir anahtarın kotası biterse oyun kendiliğinden sıradakine geçer. Kota anahtara değil projeye aittir; aynı projeden alınan ikinci bir anahtar hiçbir şey kazandırmaz, her anahtar ayrı bir Google Cloud projesinden olmalıdır. Bunu yapmadan önce riski bil. Google'ın YouTube API geliştirici politikaları bir uygulama için tek proje öngörür (III.D.1. bölüm), politikalara aykırı projeleri askıya alabilir ve askıdan sonra yeni proje açılmasına da izin vermez. Birden fazla anahtar kullanırsan karar da Google hesabın da senin.

Anahtarı gizli tut

• API ayarları penceresini yayında asla gösterme. Anahtarı not alan herkes kotanı harcayabilir.
• Bir anahtar sızarsa Kimlik bilgileri'nden sil ve yenisini oluştur. Bir dakika sürer ve eski anahtar anında çalışmaz olur.
• Anahtarı YouTube Data API v3 ile sınırlamak (yukarıdaki 4. adım), bir sızıntının zararını o tek API ile sınırlar.

Oyun neyi okur, neyi okumaz?

Anahtar, oyunun yayınındaki herkese açık sohbeti okumasını sağlar: izleyen herkesin zaten görebildiği mesajları. Kanalına, videolarına, yorumlarına ya da hesabına erişim vermez ve hiçbir şey paylaşamaz. Bu yüzden burada bir anahtar yeterlidir ve oyun senden YouTube'a giriş yapmanı istemez.