Uygulama: Altyazılar

Aşağıdaki örneklerde, altyazılarla ilgili işlevleri gerçekleştirmek için YouTube Data API'nin (v3) nasıl kullanılacağı gösterilmektedir.

Bir videonun altyazı parçalarının listesini alma

Belirli bir video için kullanılabilen altyazı izleri listesini almak üzere captions.list yöntemini çağırın. videoId parametre değerini, altyazılarını aldığınız videoyu benzersiz şekilde tanımlayan YouTube video kimliğine ayarlayın. İsteğiniz OAuth 2.0 kullanılarak yetkilendirilmelidir.

Aşağıdaki istek, Google Stories YouTube kanalındaki bir videonun altyazılarının listesini alır:

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.captions.list?
part=snippet
&videoId=PRU2ShMzQRg

Kod örnekleri için captions.list yönteminin dokümanlarına bakın.

Altyazı parçası oluşturma

API Gezgini, bu yöntem için gerekli olan dosya yükleme özelliğini desteklemediğinden bu sorgu API Gezgini kullanılarak test edilemez.

Bir videoya yeni altyazı parçası yüklemek için API'nin captions.insert yöntemini kullanabilirsiniz. Parça yüklerken aşağıdaki caption kaynak özellikleri için bir değer belirtmeniz gerekir:

• snippet.videoId: Altyazı parçasının eklendiği videoyu tanımlar.
• snippet.language: Altyazı parçasının dili.
• snippet.name: Altyazı parçasının adı.

Altyazı parçası yüklerken aşağıdaki ek seçenekleri kullanabilirsiniz:

• sync parametresini true olarak ayarlarsanız YouTube, yüklenen altyazı dosyasında bulunan tüm zaman kodlarını yoksayar ve altyazılar için yeni zaman kodları oluşturur.

  Zaman kodu içermeyen bir transkript yüklüyorsanız veya dosyanızdaki zaman kodlarının yanlış olduğundan şüphelenip YouTube'un bunları düzeltmesini istiyorsanız sync parametresini true olarak ayarlamanız gerekir.

• caption kaynağının snippet.isDraft mülkünü true olarak ayarlarsanız parça herkese açık olarak görünmez.

Kod örnekleri için captions.insert yönteminin dokümanlarına bakın.

Altyazı parçasını indirme

API Gezgini, dosya indirme özelliğini desteklemediğinden bu sorgu API Gezgini kullanılarak test edilemez.

Belirli bir altyazı parçasını indirmek için captions.download yöntemini çağırın. id parametre değerini, indirdiğiniz altyazı parçasını benzersiz şekilde tanımlayan YouTube altyazı parçası kimliğine ayarlayın. İsteğiniz OAuth 2.0 kullanılarak yetkilendirilmelidir.

v3 API aşağıdaki seçenekleri destekler:

• Altyazı kanalının belirli bir biçimde döndürülmesi gerektiğini belirtmek için tfmt parametre değerini, istediğiniz biçimi tanımlayacak şekilde ayarlayın. Parametre tanımı, desteklenen değerleri listeler.

• Altyazı kanalının çevirisini almak için tlang parametre değerini, istenen altyazı dilini tanımlayan ISO 639-1 iki harfli dil koduna ayarlayın. Çeviri, Google Çeviri gibi bir makine çevirisi kullanılarak oluşturulur.

Kod örnekleri için captions.download yönteminin dokümanlarına bakın.

Altyazı parçasını güncelleme

API, altyazı parçasının taslak durumunu değiştirme, bir dosya için yeni altyazı parçası yükleme veya her ikisini birden yapma olanağı sunar.

Bir kanalın taslak durumunu değiştirme özelliğini test etmek için API Gezgini'ni kullanabilirsiniz. Ancak API Gezgini, dosya yükleme özelliğini desteklemediğinden asıl altyazı parçasını güncellemek için kullanılamaz.

Aşağıdaki istek, Google Stories YouTube kanalındaki bir videonun altyazılarının listesini alır:

İstek, altyazı parçasının taslak durumunu true olarak günceller. Bu durumda parça herkese açık olarak gösterilmez. İsteği APIs Explorer'da tamamlamak için id mülkünün değerini altyazı parçasını tanımlayacak şekilde ayarlamanız gerekir.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.captions.update?
part=snippet

Kod örnekleri için captions.update yönteminin dokümanlarına bakın.

Altyazı parçasını silme

Bu örnekte, altyazı parçasının nasıl silineceği gösterilmektedir. Örnekte aşağıdaki adımlar yer alır:

• 1. Adım: Altyazı parçası kimliğini alın

  Bir videonun altyazı parçalarının listesini almak için yukarıdaki adımları uygulayın. Bu liste, her parçanın kimliği anahtar olarak kullanılarak altyazı parçalarının listesini görüntülemek için kullanılabilir.

• 2. Adım: Parçayı silin

  Belirli bir videoyu silmek için captions.delete yöntemini çağırın. İstekte id parametresi, sildiğiniz parçanın altyazı parçası kimliğini belirtir. İstek, OAuth 2.0 kullanılarak yetkilendirilmelidir. Bu sorguyu API Gezgini'nde test ediyorsanız id parametre değeri için geçerli bir altyazı parçası kimliği kullanmanız gerekir.

  https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.captions.delete?
  id=CAPTION_TRACK_ID