Bu sayfa, Cloud Translation API ile çevrilmiştir.

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

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

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

Java 1.7 veya daha yeni bir sürüm.
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

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

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.
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 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şturma Uygulama türünü Diğer 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 müşteri kimliğidir.

2. adım: Projeyi hazırlayın

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

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

Çalışma dizininizdeki build.gradle dosyasını açın ve içeriğini aşağıdakilerle 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'
}

build.gradle dosyasında, REVISION ve CL_VERSION değişkenlerini YouTube Data API'nin istemci kitaplığı dokümanındaki iki değerle değiştirmeniz gerekir. YouTube Analytics API'si 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ı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.

API'nin channels.list yöntemiyle ilgili dokümanları açın.
Bu sayfadaki "Yaygın kullanım alanları" bölümünde, yöntemin yaygın olarak kullanıldığı çeşitli yolları açıklayan 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.
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ş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.
Tam ekran API Gezgini'nin sağ tarafında, farklı dillerde kod örnekleri içeren sekmeler gösterilir. Java sekmesini seçin.
Kod örneğini kopyalayın ve 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.
İ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.
Örneği komut satırından çalıştırın. Çalışma dizininizde şunu çalıştırın:

gradle -q run
Örnek, isteği yürütmeli ve yanıtı STDOUT konumuna yazdırmalıdır.

4. 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ştireceksiniz. Bu istek için kullanıcı yetkilendirmesi gerekir.

API'nin channels.list yöntemiyle ilgili belgelere geri dönün.
"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.
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.
Önceki örnekte olduğu gibi Java sekmesini seçin, kod örneğini kopyalayın ve src/main/java/ApiExample.java konumuna kaydedin.
Örneği komut satırından çalıştırın. Çalışma dizininizde şunu çalıştırın:

gradle -q run
Ö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 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ı'nda oturum açtıysanız yetkilendirme için kullanmak istediğiniz hesabı seçmeniz istenir.
Uygulamanıza kod örneğinizde belirtilen kapsamlara erişim izni vermek için düğmeyi tıklayın.
Örnek otomatik olarak devam eder ve yetkilendirme akışı için kullanılan tarayıcı sekmesini kapatabilirsiniz.

API yanıtı tekrar STDOUT konumuna yazdırılmalıdır.