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

Bu hızlı başlangıç kılavuzunda, YouTube Data API'ye istekte bulunan basit, PHP komut satırı uygulamasının nasıl oluşturulacağı açıklanmaktadır. Bu hızlı başlangıç kılavuzunda iki API isteğinin nasıl oluşturulacağı açıklanmaktadır:

  1. GoogleDevelopers YouTube kanalıyla ilgili bilgileri almak için uygulamanızı tanımlayan bir API anahtarı kullanırsınız.
  2. 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:

  • Komut satırı arayüzü (KSA) ve JSON uzantısı yüklüyken PHP 5.4 veya sonraki sürümler.
  • Composer bağımlılık yönetim aracı tüm dünyada yüklenir {: target="_blank"}
  • PHP için Google API'leri İstemci Kitaplığı:
    • İstemci kitaplığını daha önce yüklemediyseniz: 
      composer require google/apiclient:^2.0
    • İstemci kitaplığını daha önce yüklediyseniz test ettiğiniz kitaplıkla ilgili en güncel sınıflara 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

API Konsolu'nda bir proje oluşturun veya seçin. Projeniz için API Konsolu'nda aşağıdaki görevleri tamamlayın:

  1. 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.

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

    1. 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.

    2. 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. Burada CLIENTID, 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.

  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 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.

    channel.list dokümanlarının kullanım alanlarını listeleyen tabloda kod simgesi 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şkilendirilen kullanım alanını belirtir.

  3. Tam ekran API'lar Gezgini'nin sol tarafında aşağıdakiler gösterilir:

    1. İstek parametreleri başlığının altında, yöntemin desteklediği parametrelerin bir listesi bulunur. 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 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'ler Gezgini'ndeki "Kimlik Bilgileri"ni ve "API anahtarı" seçeneği işaretlenmiş açılır menüyü gösteren resim.

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

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

  6. İ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.

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

    php example.php

  8. Ö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.

  1. API'nin channels.list yöntemiyle ilgili belgelere 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 "kanalım" için list yöntemini çağırmak gerekir.

  3. 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:

    1. Parametreler bölümünde, id parametre değeri ayarlanmak yerine mine parametre değeri true 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.

    2. 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.

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

  4. Önceki örnekte olduğu gibi PHP sekmesini seçin, kod örneğini kopyalayın ve example.php'a 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.

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

    php example.php

  6. 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.

  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ı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.

Daha fazla bilgi