Python Hızlı Başlangıç

Bu hızlı başlangıç kılavuzunda, YouTube Data API'ye istek gönderen basit bir 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 yapılacağı açıklanmaktadır:

  1. GoogleDevelopers YouTube kanalıyla ilgili bilgileri almak için uygulamanızı tanımlayan bir API anahtarı kullanacaksınız.
  2. Kendi YouTube kanalınızla ilgili bilgileri alan yetkili bir istek göndermek için OAuth 2.0 istemci kimliği kullanırsınız.

Ön koşullar

Bu hızlı başlangıcı çalıştırmak için ihtiyacınız olanlar:

  • Python 2.7 veya Python 3.5+

  • pip paket yönetim aracı

  • Python için Google API'leri İstemci Kitaplığı:

    pip install --upgrade google-api-python-client
    
  • Kullanıcı yetkilendirmesi için google-auth-oauthlib ve google-auth-httplib2 kitaplıkları.

    pip install --upgrade google-auth-oauthlib google-auth-httplib2
    

1. adım: Projenizi ve kimlik bilgilerinizi ayarlayın

Cloud Console'da bir proje oluşturun veya seçin. Projeniz için Cloud Console'da aşağıdaki görevleri tamamlayın:

  1. Kitaplık panelinde YouTube Data API v3'ü arayın. Bu API'nin girişini tıklayın ve API'nin projeniz için etkinleştirildiğinden emin olun.

  2. Kimlik bilgileri panelinde iki kimlik bilgisi oluşturun:

    1. API anahtarı oluşturma Kullanıcı yetkilendirmesi gerektirmeyen API istekleri göndermek için API anahtarını kullanacaksınız. Örneğin, herkese açık bir YouTube kanalı hakkında bilgi almak için kullanıcı yetkilendirmesi gerekmez.

    2. OAuth 2.0 istemci kimliği oluşturun Uygulama türünü Masaüstü uygulaması olarak ayarlayın. Kullanıcı yetkilendirmesi gerektiren istekler için OAuth 2.0 kimlik bilgilerini kullanmanız gerekir. Örneğin, şu anda kimliği doğrulanmış kullanıcının YouTube kanalıyla ilgili bilgileri almak için kullanıcı yetkilendirmesi gerekir.

      OAuth 2.0 kimlik bilgilerinizi içeren JSON dosyasını indirin. Dosyanın adı client_secret_CLIENTID.json gibi bir addır. Burada CLIENTID, projenizin istemci kimliğidir.

2. adım: Örnek uygulamayı ayarlayın ve çalıştırın

GoogleDevelopers YouTube kanalı hakkında bilgi almak için örnek kod almak üzere yan paneldeki API Gezgini widget'ını kullanın. Bu istek, uygulamanızı tanımlamak için bir API anahtarı kullanır ve kullanıcının yetkilendirmesini ya da örneği çalıştıran kullanıcıdan herhangi bir özel izin alınmasını gerektirmez.

  1. API'nin channels.list yöntemiyle ilgili dokümanları açın.
  2. Bu sayfadaki "Yaygın kullanım alanları" bölümünde, yöntemin yaygın olarak kullanıldığı birkaç yöntemi açıklayan bir tablo bulunur. Tablodaki ilk giriş, kanal kimliğine göre listeleme sonuçları içindir.

    Tam ekran API Gezgini'ni açıp doldurmak için ilk listelemenin kod simgesini tıklayın.

    channels.list dokümanındaki kanalların kullanım alanlarını listeleyen tabloda kod sembolü bağlantısının konumunu tanımlayan resim. Bu resmin alternatif metni, resmi bir kod simgesi olarak tanımlar ve bu bağlantıyla ilişkili kullanım alanını belirtir.

  3. Tam ekran API Gezgini'nin sol tarafında şunlar gösterilir:

    1. İstek parametreleri başlığının altında, yöntemin desteklediği parametrelerin listesi yer alır. part ve id parametre değerleri ayarlanmalıdır. id parametre değeri, UC_x5XG1OV2P6uZZ5FSM9Ttw, GoogleDevelopers YouTube kanalının kimliğidir.

    2. Parametrelerin altında Kimlik bilgileri adlı bir bölüm bulunur. Bu bölümdeki açılır menüde API anahtarı değeri gösterilmelidir. API Gezgini, kullanmaya 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 Gezgini'nde "Kimlik bilgileri"ni ve "API anahtarı" seçeneğinin belirlendiği açılır menüyü gösteren resim.

  4. Tam ekran API Gezgini'nin sağ tarafında, farklı dillerde kod örnekleri içeren sekmeler gösterilir. Python sekmesini seçin.

  5. Kod örneğini kopyalayıp example.py adlı bir dosyaya kaydedin.

  6. İndirdiğiniz örnekte YOUR_API_KEY dizesini bulun ve bu dizeyi, bu hızlı başlangıcın 1. adımında oluşturduğunuz API anahtarıyla değiştirin.

  7. Örneği komut satırından çalıştırın. Çalışma dizininizde şu komutu çalıştırın:

    python example.py

  8. Örnek, isteği yürütmeli ve yanıtı STDOUT konumuna yazdırmalıdır.

3. adım: Yetkilendirilmiş bir istek çalıştırın

Bu adımda, kod örneğinizi GoogleDevelopers YouTube kanalı yerine kendi YouTube kanalınızla ilgili bilgileri alacak şekilde değiştireceksiniz. Bu istek için kullanıcı yetkilendirmesi gerekir.

  1. API'nin channels.list yöntemiyle ilgili belgelere geri dönün.

  2. "Sık kullanılan kullanım alanları" bölümünde, tablodaki üçüncü girişin kod simgesini tıklayın. Bu kullanım alanı, "kanalım" için list yöntemini çağırmaktır.

  3. Tam ekran API Gezgini'nin sol tarafında, parametrelerin listesini ve ardından Kimlik bilgileri bölümünü görürsünüz. Ancak GoogleDevelopers kanalıyla ilgili bilgi aldığınız örnekten farklı iki değişiklik vardır:

    1. Parametreler bölümünde, id parametre değeri yerine mine parametre değeri true olarak ayarlanmalıdır. Bu, API sunucusuna, kimliği doğrulanmış kullanıcının kanalıyla ilgili bilgileri alması talimatını verir.

    2. Kimlik bilgileri bölümündeki açılır menüde Google OAuth 2.0 seçeneği belirlenmelidir.

      Ayrıca, Kapsamları göster bağlantısını tıklarsanız https://www.googleapis.com/auth/youtube.readonly kapsamı işaretlenmelidir.

      Tam ekran API Gezgini'ndeki kapsamları ve "Google OAuth 2.0" kimlik bilgilerini kullanma seçeneğinin belirlendiğini gösteren resim.

  4. Önceki örnekte olduğu gibi Python sekmesini seçin, kod örneğini kopyalayın ve example.py konumuna kaydedin.

    Kodda YOUR_CLIENT_SECRET_FILE.json dizesini bulun ve bu dizeyi, bu hızlı başlangıç kılavuzunun 1. adımında indirdiğiniz istemci gizli anahtarı dosyasının konumuyla değiştirin.

  5. Örneği komut satırından çalıştırın. Çalışma dizininizde şu komutu çalıştırın:

    python example.py

  6. Konsoldan URL'yi kopyalayın ve tarayıcınızda açın.

    Google Hesabınıza henüz giriş yapmadıysanız giriş yapmanız istenir. Birden fazla Google Hesabı'na giriş yaptıysanız yetkilendirme için kullanmak üzere bir hesap seçmeniz istenir.

  7. Uygulamanıza, kod örneğinizde belirtilen kapsamlara erişim izni vermek için düğmeyi tıklayın.

  8. Tarayıcıdan yetkilendirme kodunu kopyalayıp terminalinize yapıştırın. Ardından, kimlik doğrulama akışı için kullanılan tarayıcı sekmesini kapatabilirsiniz.

    API yanıtı tekrar STDOUT olarak yazdırılmalıdır.

Daha fazla bilgi