Bu hızlı başlangıç kılavuzunda, YouTube Data API'ye istekte bulunan basit, Python komut satırı uygulamasının nasıl ayarlanacağı açıklanmaktadır. Bu hızlı başlangıç kılavuzunda iki API isteğinin nasıl oluşturulacağı açıklanmaktadır:
- GoogleDevelopers YouTube kanalıyla ilgili bilgileri almak için uygulamanızı tanımlayan bir API anahtarı kullanırsınız.
- Kendi YouTube kanalınız hakkında bilgi alan yetkili bir istek göndermek için OAuth 2.0 istemci kimliğini kullanırsınız.
Ön koşullar
Bu hızlı başlangıç kılavuzunu çalıştırmak için aşağıdakilere ihtiyacınız vardır:
Python 2.7 veya Python 3.5+
pip
paket yönetimi aracıPython için Google API'leri İstemci Kitaplığı
pip install --upgrade google-api-python-client
Kullanıcı yetkilendirme için
google-auth-oauthlib
vegoogle-auth-httplib2
kitaplıkları.pip install --upgrade google-auth-oauthlib google-auth-httplib2
1. Adım: Projenizi ve kimlik bilgilerinizi ayarlayın
API Konsolu'nda bir proje oluşturun veya seçin. Projeniz için API Konsolu'nda aşağıdaki görevleri tamamlayın:
Kitaplık panelinde YouTube Data API v3'ü arayın. API'nin girişini tıklayın ve projeniz için API'nin etkinleştirildiğinden emin olun.
Kimlik bilgisi panelinde iki kimlik bilgisi oluşturun:
API anahtarı oluşturma Kullanıcı yetkilendirmesini gerektirmeyen API isteklerinde bulunmak için API anahtarını kullanırsınız. Örneğin, herkese açık bir YouTube kanalı hakkında bilgi almak için kullanıcı yetkilendirmesine ihtiyacınız yoktur.
OAuth 2.0 istemci kimliği oluşturma Uygulama türünü Diğer olarak ayarlayın. Kullanıcı yetkilendirme gerektiren istekler için OAuth 2.0 kimlik bilgilerini kullanmanız gerekir. Örneğin, şu anda kimliği doğrulanmış olan kullanıcının YouTube kanalıyla ilgili bilgileri almak için kullanıcı yetkilendirmesine ihtiyacınız vardır.
OAuth 2.0 kimlik bilgilerinizi içeren JSON dosyasını indirin. Dosya,
client_secret_CLIENTID.json
gibi bir ada sahip. BuradaCLIENTID
, projenizin istemci kimliğidir.
2. Adım: Örneği ayarlayıp çalıştırın
GoogleDevelopers YouTube kanalıyla ilgili bilgileri almak üzere örnek kod almak için yan paneldeki API Gezgini widget'ını kullanın. Bu istek, uygulamanızı tanımlamak için bir API anahtarı kullanır ve örneği çalıştıran kullanıcıdan kullanıcı yetkilendirmesi veya özel izinler gerektirmez.
- API'nin channels.list yöntemiyle ilgili dokümanları açın.
Bu sayfadaki "Yaygın kullanım alanları" bölümünde, yöntemin kullanıldığı bazı yaygın yolları açıklayan bir tablo yer alır. Tablodaki ilk giriş, sonuçları kanal kimliğine göre listelemeye yöneliktir.
Tam ekran API'ler Gezgini'ni açmak ve doldurmak için ilk girişin kod simgesini tıklayın.
Tam ekran API'lar Gezgini'nin sol tarafında aşağıdakiler gösterilir:
İstek parametreleri başlığının altında, yöntemin desteklediği parametrelerin bir listesi bulunur.
part
veid
parametre değerleri ayarlanmalıdır.id
parametre değeri (UC_x5XG1OV2P6uZZ5FSM9Ttw
), GoogleDevelopers YouTube kanalının kimliğidir.Parametrelerin altında Kimlik bilgileri adlı bir bölüm vardır. Bu bölümdeki açılan menüde API anahtarı değeri gösterilmelidir. API Gezgini, başlamayı kolaylaştırmak için varsayılan olarak demo kimlik bilgilerini kullanır. Ancak örneği yerel olarak çalıştırmak için kendi API anahtarınızı kullanırsınız.
Tam ekran API'lar Gezgini'nin sağ tarafında, farklı dillerde kod örnekleri içeren sekmeler gösterilir. Python sekmesini seçin.
Kod örneğini kopyalayıp
example.py
adlı bir dosyaya kaydedin.İndirdiğiniz örnekte
YOUR_API_KEY
dizesini bulun ve bu hızlı başlangıç kılavuzunun 1. adımında oluşturduğunuz API anahtarıyla değiştirin.Örneği komut satırından çalıştırın. Çalışma dizininizde şunları çalıştırın:
python example.py
Örnek, isteği yürütmeli ve yanıtı
STDOUT
adresine yazdırmalıdır.
3. Adım: Yetkilendirilmiş bir istek çalıştırın
Bu adımda, Google Developers YouTube kanalıyla ilgili bilgileri almak yerine sizin YouTube kanalınızla ilgili bilgileri alacak şekilde kod örneğinizi değiştirirsiniz. Bu istek için kullanıcı yetkilendirme gereklidir.
API'nin channels.list yöntemiyle ilgili belgelere dönün.
"Yaygın kullanım alanları" bölümünde, tablodaki üçüncü girişin kod simgesini tıklayın. Bu kullanım alanında "kanalım" için
list
yöntemini çağırmak gerekir.Yine, tam ekran API'ler Gezgini'nin sol tarafında, parametrelerin ve ardından Credentials (Kimlik bilgileri) bölümünün listesini görürsünüz. Ancak GoogleGeliştiriciler kanalıyla ilgili bilgileri aldığınız örnekten iki değişiklik var:
Parametreler bölümünde,
id
parametre değeri ayarlanmak yerinemine
parametre değeritrue
olarak ayarlanmalıdır. Bu işlem, API sunucusuna kimliği doğrulanmış durumda olan kullanıcının kanalıyla ilgili bilgileri alma talimatı verir.Credentials (Kimlik Bilgileri) bölümünde açılır menüden Google OAuth 2.0 seçeneğini belirlemelisiniz.
Ek olarak, Kapsamları göster bağlantısını tıklarsanız https://www.googleapis.com/auth/youtube.readonly kapsamı kontrol edilmelidir.
Önceki örnekte olduğu gibi Python sekmesini seçin, kod örneğini kopyalayın ve
example.py
öğesine kaydedin.Kodda,
YOUR_CLIENT_SECRET_FILE.json
dizesini bulun ve bu hızlı başlangıç adımının 1. adımında indirdiğiniz istemci gizli dosyasının konumunu değiştirin.Örneği komut satırından çalıştırın. Çalışma dizininizde şunları çalıştırın:
python example.py
-
Konsoldaki URL'yi kopyalayıp tarayıcınızda açın.
Google hesabınıza giriş yapmadıysanız giriş yapmanız istenir. Birden çok Google hesabına giriş yaptıysanız yetkilendirme için kullanılacak bir hesap seçmeniz istenir.
Uygulamanıza, kod örneğinizde belirtilen kapsamlara erişim izni vermek için düğmeyi tıklayın.
-
Tarayıcıdan yetkilendirme kodunu kopyalayın ve terminalinize yapıştırın. Ardından, kimlik doğrulama akışı için kullanılan tarayıcı sekmesini kapatabilirsiniz.
API yanıtı
STDOUT
için tekrar yazdırılmalıdır.