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ıç kılavuzunda, iki API isteğinin nasıl yapılacağı açıklanmaktadır:

1. GoogleDevelopers YouTube kanalı hakkında bilgi 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.

Not: Genel olarak, API anahtarı kullanan tüm kullanım alanları için ilk örnekteki talimatları, OAuth 2.0 kullanarak yetkilendirme gerektiren tüm kullanım alanları için ise ikinci örnekteki talimatları uygulayabilirsiniz. Daha fazla örnek için 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 daha yeni bir sürüm.
• Genel olarak yüklenmiş Composer bağımlılık yönetimi aracı
• PHP için Google API'leri İstemci Kitaplığı:
  • İstemci kitaplığını daha önce 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 listesini 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ı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 şeklindedir. 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ı yetkilendirmesi veya örneği çalıştıran kullanıcıdan ö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 yaygın olarak kullanıldığı birkaç yöntemi açıklayan bir tablo bulunur. Tablodaki ilk giriş, sonuçları kanal kimliğine göre listelemek içindir.

   İlk girişin kod simgesini tıklayarak tam ekran API Gezgini'ni açın ve doldurun.

   

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, başlangıçta kolaylık sağlamak 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.

      

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ı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 şu komutu çalıştırın:

   php example.php

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

3. adım: Yetkili 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öntemine ilişkin belgelere geri dönün.

2. "Common use cases" (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. 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.

      

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

   php example.php

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

   Henüz Google Hesabınıza giriş yapmadıysanız giriş yapmanız istenir. Birden fazla Google Hesabı'nda oturum açtı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 kimlik doğrulama 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

• Google Developers Console yardım belgeleri
• PHP için Google API'leri istemci kitaplığı dokümanları
• GitHub'daki PHP için Google API'leri istemci kitaplığı ve YouTube API için otomatik olarak oluşturulan sınıflar. (Sayfada YouTube klasörünü ve YouTube.php dosyasını bulun.
• YouTube Data API referans belgeleri