Aşağıdaki örneklerde, altyazılarla ilgili işlevlerin yerine getirilmesi için YouTube Data API'sinin (v3) nasıl kullanılacağı gösterilmektedir.
Videoya ait altyazı parçalarının listesini alma
Belirli bir videoda kullanılabilen altyazı parçalarının listesini almak için captions.list
yöntemini çağırın. videoId
parametre değerini, altyazıları 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 Hikayeler YouTube kanalındaki bir videonun altyazı 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ı oluşturun
API Gezgini, dosya yükleme özelliğini desteklemediğinden bu sorgu API Gezgini kullanılarak test edilemez.
Bir videoya yeni bir altyazı parçası yüklemek için API'nin captions.insert
yöntemini kullanabilirsiniz. Bir parça yüklerken aşağıdaki caption
kaynak mülkleri için bir değer belirtmeniz gerekir:
snippet.videoId
: Bu, altyazı parçasının eklendiği videoyu tanımlar.snippet.language
: Altyazı parçasının dilidir.snippet.name
- Altyazı parçasının adıdır.
Altyazı parçası yüklerken aşağıdaki ek seçenekler kullanılabilir:
-
sync
parametresinitrue
olarak ayarlarsanız YouTube, yüklenen altyazı dosyasındaki zaman kodlarını dikkate almaz 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 şüpheleniyorsanız ve YouTube'un bunları düzeltmeyi denemesini istiyorsanız
sync
parametresinitrue
olarak ayarlamanız gerekir. -
caption
kaynağınınsnippet.isDraft
özelliğinitrue
olarak ayarlarsanız parça herkese açık olarak görüntülenmez.
Kod örnekleri için captions.insert
yönteminin dokümanlarına bakın.
Altyazı parçası indirin
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:
-
Bir altyazı parçasının belirli bir biçimde döndürülmesi gerektiğini belirtmek için,
tfmt
biçimini, istediğiniz biçimi tanımlamak üzere ayarlayın. Parametre tanımında desteklenen değerler listelenir. -
Bir altyazı parçasının çevirisini almak için
tlang
parametre değerini, istenen altyazı dilini tanımlayan bir ISO 639-1 iki harfli dil kodu olarak 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, dosya için yeni altyazı parçası yükleme veya ikisini birden yapabilme olanağını destekler.
Bir parçanın taslak durumunu değiştirme özelliğini test etmek için API Gezgini'ni kullanabilirsiniz. Ancak araç, dosya yükleme özelliğini desteklemediğinden API altyazısını güncellemek için gerçek altyazı parçasını kullanamazsınız.
Aşağıdaki istek, Google Hikayeler YouTube kanalındaki bir videonun altyazı listesini alır:
İstek, altyazı parçasının taslak durumunu true
olarak günceller. Bu da parçanın herkese görünür olmayacağı anlamına gelir. İsteği API Gezgini'nde tamamlamak için bir altyazı parçasını tanımlamak üzere id
özelliğinin değerini 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ı silme
Bu örnekte, altyazı parçasının nasıl silineceği gösterilmektedir. Örnekte aşağıdaki adımlar bulunmaktadır:
-
1. Adım: Altyazı parçası kimliğini alın
Videoya ait altyazı parçalarının listesini almak için yukarıdaki adımları uygulayın. Liste, her parçanın kimliğini anahtar olarak kullanarak 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. İstekteid
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ızid
parametre değeri için geçerli bir altyazı parçası kimliği değiştirmeniz gerekir.https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.captions.delete? id=CAPTION_TRACK_ID