Implementasi: Teks

Untuk mengambil daftar trek teks yang tersedia untuk video tertentu, panggil metode captions.list. Tetapkan nilai parameter videoId ke ID video YouTube yang mengidentifikasi video secara unik saat Anda mengambil teks. Permintaan Anda harus diotorisasi menggunakan OAuth 2.0.

Permintaan di bawah ini mengambil daftar teks untuk video di channel YouTube Google Stories:

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

Lihat dokumentasi metode captions.list untuk contoh kode.

Kueri ini tidak dapat diuji menggunakan APIs Explorer karena APIs Explorer tidak mendukung kemampuan mengupload file yang merupakan persyaratan untuk metode ini.

Anda dapat menggunakan metode captions.insert API untuk mengupload trek teks baru untuk video. Saat mengupload trek, Anda harus menentukan nilai untuk properti resource caption berikut:

• snippet.videoId - Mengidentifikasi video yang akan ditambahi trek teks.
• snippet.language - Bahasa trek teks.
• snippet.name - Nama trek teks.

Opsi tambahan berikut tersedia saat mengupload trek teks:

• Jika Anda menyetel parameter sync ke true, YouTube akan mengabaikan kode waktu yang ada dalam file teks yang diupload dan membuat kode waktu baru untuk teks tersebut.

  Anda harus menyetel parameter sync ke true jika mengupload transkrip, yang tidak memiliki kode waktu, atau jika Anda mencurigai bahwa kode waktu di file salah dan ingin YouTube mencoba memperbaikinya.

• Jika Anda menetapkan properti snippet.isDraft resource caption ke true, trek tidak akan terlihat secara publik.

Lihat dokumentasi metode captions.insert untuk contoh kode.

Kueri ini tidak dapat diuji menggunakan APIs Explorer karena APIs Explorer tidak mendukung kemampuan mendownload file.

Untuk mendownload trek teks tertentu, panggil metode captions.download. Setel nilai parameter id ke ID trek teks YouTube yang secara unik mengidentifikasi trek teks yang sedang Anda download. Permintaan Anda harus diotorisasi menggunakan OAuth 2.0.

API v3 mendukung opsi berikut:

• Untuk menentukan bahwa trek teks harus ditampilkan dalam format tertentu, tetapkan nilai parameter tfmt untuk mengidentifikasi format yang diinginkan. Definisi parameter mencantumkan nilai yang didukung.

• Untuk mengambil terjemahan trek teks, setel nilai parameter tlang ke kode bahasa dua huruf ISO 639-1 yang mengidentifikasi bahasa teks yang diinginkan. Terjemahan dibuat dengan menggunakan terjemahan mesin, seperti Google Terjemahan.

Lihat dokumentasi metode captions.download untuk contoh kode.

API ini mendukung kemampuan untuk mengubah status draf trek teks, mengupload trek teks baru untuk file, atau keduanya.

Anda dapat menggunakan APIs Explorer untuk menguji kemampuan mengubah status draf trek. Namun, Anda tidak dapat menggunakan APIs Explorer untuk memperbarui trek teks yang sebenarnya karena alat tidak mendukung kemampuan untuk mengupload file.

Permintaan di bawah ini mengambil daftar teks untuk video di channel YouTube Google Stories:

Permintaan tersebut memperbarui status draf trek teks menjadi true, yang berarti trek tidak akan terlihat secara publik. Untuk menyelesaikan permintaan di Penjelajah API, Anda perlu menetapkan nilai properti id untuk mengidentifikasi trek teks.

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

Lihat dokumentasi metode captions.update untuk contoh kode.

Contoh ini menunjukkan cara menghapus trek teks. Contoh ini memiliki langkah-langkah berikut:

• Langkah 1: Ambil ID trek teks

  Ikuti langkah-langkah di atas untuk mengambil daftar trek teks untuk video. Daftar ini dapat digunakan untuk menampilkan daftar trek teks, menggunakan setiap ID trek sebagai kunci.

• Langkah 2: Hapus jalur

  Panggil metode captions.delete untuk menghapus video tertentu. Dalam permintaan tersebut, parameter id menentukan ID trek teks dari trek yang Anda hapus. Permintaan harus diotorisasi menggunakan OAuth 2.0. Jika menguji kueri ini di APIs Explorer, Anda harus mengganti ID trek teks yang valid untuk nilai parameter id.

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