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

Bu hızlı başlangıç kılavuzunda, YouTube Data API'ye istek gönderen basit bir Java 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: Daha genel olarak, API anahtarı kullanılan tüm kullanım alanları için ilk örnekteki talimatları, OAuth 2.0 kullanılarak 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:

• Java 1.7 veya sonraki sürümler.
• Gradle 2.3 veya daha yeni bir sürüm.
• İnternet erişimi ve web tarayıcısı
• Google Hesabı

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 API anahtarını, kullanıcı yetkilendirmesi gerektirmeyen API istekleri göndermek için kullanırsı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şturma 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, kimliği doğrulanmış mevcut 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: Projeyi hazırlayın

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

1. Çalışma dizininizde aşağıdaki komutları çalıştırarak yeni bir proje yapısı oluşturun:

   $ 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 dosyayı client_secret.json olarak yeniden adlandırın.

3. Çalışma dizininizdeki build.gradle dosyasını açın ve içeriğini aşağıdakiyle 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'nin istemci kitaplığı belgelerindeki iki değerle değiştirmeniz gerekir. YouTube Analytics API belgelerinin yer aldığı 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 ayarlama ve çalıştırma

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 olan 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ı kullanacaksınız.

      

4. Tam ekran API 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. Farklı örnekleri çalıştırmak için build.gradle dosyasını değiştirmeniz gerekmemesi amacıyla her örnekte aynı sınıf adı (ApiExample) kullanılır.

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:

   gradle -q run

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

4. adım: Yetkili bir istek çalıştırma

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ş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ının işaretli olması gerekir.

      

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

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

   gradle -q run

6. Örnek, varsayılan tarayıcınızda yeni bir pencere veya sekme açmaya çalışır. Bu işlem başarısız olursa URL'yi terminalden kopyalayıp tarayıcınızda manuel olarak 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. Örnek otomatik olarak devam eder ve 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
• Java için Google API'leri istemci kitaplığı belgeleri
• YouTube Data API Javadoc dokümanları
• YouTube Data API referans belgeleri