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

Bu hızlı başlangıç kılavuzunda, YouTube Data API'ye istekte bulunan basit, Java 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.

Not: Daha genel olarak ifade etmek gerekirse, API anahtarı kullanan tüm kullanım alanları için ilk örnekle ilgili talimatları veya OAuth 2.0 kullanarak yetkilendirme gerektiren tüm kullanım alanları için ikinci örnekle ilgili talimatları uygulayabilirsiniz. Daha fazla örnek için kullanım alanları ve kod örnekleri aracına göz atın.

Ön koşullar

Bu hızlı başlangıç kılavuzunu çalıştırmak için aşağıdakilere ihtiyacınız vardır:

• Java 1.7 veya sonraki sürümler.
• Gradle 2.3 veya üstü.
• İnternete ve web tarayıcısına erişim.
• Google Hesabı.

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: Projeyi hazırlayın

Gradle projenizi hazırlamak için aşağıdaki adımları uygulayın:

1. Çalışma dizininizde, yeni bir proje yapısı oluşturmak için aşağıdaki komutları çalıştırın:

   $ gradle init --type basic
   $ mkdir -p src/main/java src/main/resources
   

2. OAuth 2.0 istemci kimliğinizi oluşturduktan sonra indirdiğiniz JSON dosyasını, çalışma dizininizin altındaki src/main/resources dizinine taşıyın ve client_secret.json olarak yeniden adlandırın.

3. Çalışma dizininizdeki build.gradle dosyasını açın ve içeriğini aşağıdaki şekilde değiştirin:

   apply plugin: 'java'
   apply plugin: 'application'
   
   mainClassName = 'ApiExample'
   sourceCompatibility = 1.7
   targetCompatibility = 1.7
   version = '1.0'
   
   repositories {
       mavenCentral()
   }
   
   dependencies {
       compile 'com.google.api-client:google-api-client:1.23.0'
       compile 'com.google.oauth-client:google-oauth-client-jetty:1.23.0'
       compile 'com.google.apis:google-api-services-youtube:v3-revREVISION-CL_VERSION'
   }
   

4. build.gradle dosyasında REVISION ve CL_VERSION değişkenlerini, YouTube Data API'sı için istemci kitaplığı dokümanlarındaki iki değerle değiştirmeniz gerekir. YouTube Analytics API dokümanlarını gösteren aşağıdaki ekran görüntüsünde iki değişkenin sayfada nerede göründüğü gösterilmektedir.

   

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

   

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.

      

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

5. Kod örneğini kopyalayıp src/main/java/ApiExample.java adlı bir dosyaya kaydedin. Her örnek aynı sınıf adını (ApiExample) kullanır. Böylece farklı örnekler çalıştırmak için build.gradle dosyasını değiştirmeniz gerekmez.

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:

   gradle -q run

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

4. Adım: Yetkilendirilmiş 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.

      

4. Önceki örnekte olduğu gibi, Java sekmesini seçin, kod örneğini kopyalayın ve src/main/java/ApiExample.java öğesine kaydedin.

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

   gradle -q run

6. Örnek, varsayılan tarayıcınızda yeni bir pencere veya sekme açmaya çalışmalıdır. Bu işlem başarısız olursa terminaldeki URL'yi kopyalayın ve tarayıcınızda manuel olarak 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. Örnek otomatik olarak devam eder ve 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

• Google Developers Console yardım dokümanları
• Java dokümanları için Google API'leri İstemci Kitaplığı
• YouTube Data API Javadoc dokümanları
• YouTube Data API referansı dokümanları