PHP Hızlı Başlangıç Kılavuzu

Bu hızlı başlangıç kılavuzunda, YouTube Data API'ye istekte bulunan basit bir PHP komut satırı uygulamasının nasıl ayarlanacağı açıklanmaktadır. Bu hızlı başlangıçta aslında 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.
kullanım alanları ve kod örnekleri aracına bakın.

Ön koşullar

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

  • Komut satırı arayüzü (KSA) ve JSON uzantısı yüklü PHP 5.4 veya üzeri.
  • Composer bağımlılık yönetimi aracı genel olarak yüklü olmalıdır.
  • PHP için Google API'leri İstemci Kitaplığı:
    • Daha önce istemci kitaplığını yüklemediyseniz: 
      composer require google/apiclient:^2.0
    • Daha önce istemci kitaplığını yüklediyseniz test ettiğiniz kitaplığın en güncel sınıflarına sahip olduğunuzdan emin olmak için kitaplığı güncellemenizi öneririz: 
      composer update google/apiclient --with-dependencies

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. İlgili API'nin listelemesini 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 API anahtarını, kullanıcı yetkilendirmesi gerektirmeyen API istekleri yapmak için kullanırsınız. Örneğin, herkese açık bir YouTube kanalıyla ilgili bilgileri 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. Burada CLIENTID, projenizin istemci kimliğidir.

2. adım: Örneği ayarlayın ve çalıştırın

GoogleDevelopers YouTube kanalı hakkında bilgi almak için yan paneldeki API Gezgini widget'ını kullanarak örnek kod elde edin. 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ığı çeşitli yolların açıklandığı bir tablo yer alır. 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.

    Kanallar.list dokümanındaki kullanım alanlarını listeleyen tabloda kod sembolü bağlantısının konumunu belirten resim. Bu resmin alternatif metni, resmi bir kod sembolü olarak tanımlar ve 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şlamanızı 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ı kullanacaksınız.

      Tam ekran API Gezgini'nde "Kimlik Bilgileri"ni ve "API anahtarı" seçeneğinin belirlenmiş olduğu 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. PHP sekmesini seçin.

  5. Kod örneğini kopyalayın ve example.php 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:

    php example.php

  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ıyla ilgili bilgileri almak yerine sizin YouTube kanalınızla ilgili bilgileri alacak şekilde değiştirirsiniz. Bu istek için kullanıcı yetkilendirmesi gerekiyor.

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

  2. "Yaygın kullanım alanları" bölümünde, tablodaki üçüncü girişin kod simgesini tıklayın. Bu kullanım alanında, "mychannel" için list yöntemi çağrılır.

  3. Yine tam ekran API Gezgini'nin sol tarafında, Kimlik Bilgileri bölümünün ardından bir parametre listesi görürsünüz. Ancak, GoogleDevelopers kanalı hakkında bilgi aldığınız örnekte iki değişiklik var:

    1. Parametreler bölümünde, id parametre değeri ayarlanmak 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ını söyler.

    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 PHP sekmesini seçin, kod örneğini kopyalayın ve example.php konumuna kaydedin.

    Koddaki YOUR_CLIENT_SECRET_FILE.json dizesini bulun ve bu hızlı başlangıcın 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:

    php example.php

  6. Konsoldan URL'yi kopyalayıp 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 istediğiniz hesabı 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'ya yazdırılmalıdır.

Daha fazla bilgi