Untuk mengaktifkan Video Stitcher API untuk project Anda, hubungi Perwakilan Akun atau hubungi Penjualan untuk mempelajari lebih lanjut.

Memecahkan masalah

Halaman ini menunjukkan cara menyelesaikan masalah pada Video Stitcher API. Error yang ditampilkan di halaman ini khusus untuk Video Stitcher API. Untuk mengetahui informasi tentang error umum di seluruh Google API, lihat halaman Error Cloud API.

Hanya error pertama yang ditampilkan. Jika permintaan mengalami beberapa error, Anda harus memperbaiki error yang ditampilkan dan mencoba lagi permintaan untuk melihat error berikutnya.

Tidak dapat mengambil playlist saat membuat sesi

Masalah berikut terjadi saat Video Stitcher API tidak dapat mengambil manifes video dari sourceUri yang ditentukan.

{
  "error": {
    "code": 404,
    "message": "got status code 403 when fetching playlist from URI \"https://example.com/manifest.m3u8\"",
    "status": "NOT_FOUND",
  }
}

Untuk menyelesaikan masalah ini, ikuti langkah-langkah di bawah:

Pastikan sourceUri yang diberikan tertaut ke manifes video yang valid.
- Gunakan curl dengan sourceUri. Jika manifes ditujukan untuk dapat diakses secara publik, pastikan URL tersebut dapat dijangkau secara publik.
- Jika sourceUri sudah benar dan manifes video memerlukan penandatanganan URL, lanjutkan ke langkah berikutnya.
Pastikan kunci CDN telah terdaftar dengan Video Stitcher API di region yang sama dengan permintaan.
- Pastikan konfigurasi kunci CDN cocok dengan nama host sourceUri yang ada. Jika konfigurasi tidak ada, daftarkan kunci CDN dengan Video Stitcher API. Tunggu minimal 5 menit hingga konfigurasi diterapkan ke layanan.
- Jika konfigurasi sudah ada, lanjutkan ke langkah berikutnya.
Jika merasa bahwa kunci pribadi yang digunakan untuk menandatangani URL salah, Anda dapat memperbarui kunci CDN terdaftar dengan kunci pribadi yang benar.

Kunci CDN sudah tidak berlaku

Jika Anda baru saja mendaftarkan atau memperbarui kunci CDN dan Video Stitcher API belum mulai menandatangani URL menggunakan konfigurasi baru, ikuti langkah-langkah di bawah untuk mendiagnosis masalahnya:

Jika kunci CDN baru-baru ini didaftarkan dengan Video Stitcher API, tunggu minimal 5 menit agar update diterapkan. Jika masalah berlanjut, lanjutkan ke langkah berikutnya.
Pastikan hanya satu kunci CDN yang terdaftar untuk satu nama host untuk region tersebut. Jika beberapa kunci CDN telah didaftarkan dengan nama host yang sama, Video Stitcher API akan memilih salah satu kunci CDN untuk menandatangani URL.
- Pastikan hanya satu kunci CDN yang telah terdaftar dengan nama host yang ditentukan untuk region tertentu. Hapus kunci CDN yang sudah tidak digunakan.

Tidak ada iklan yang disisipkan dalam sesi live

Jika tidak ada iklan yang disisipkan dalam sesi live, gunakan langkah-langkah berikut untuk mendiagnosis masalahnya:

Pastikan live stream sumber menyisipkan jeda iklan dalam manifes. Penanda iklan berikut harus ada dalam manifes video live stream untuk menunjukkannya ke Video Stitcher API guna mengganti segmen video sumber dengan segmen iklan.
- Jika manifes video sumber tidak memiliki penanda iklan, berarti encoder belum memicu jeda iklan atau perlu diubah untuk menyisipkan penanda iklan yang didukung.
- Jika penanda iklan terlihat jelas dalam manifes sumber, lanjutkan ke langkah berikutnya.
Pastikan tag iklan yang diberikan menampilkan respons VAST yang tidak kosong.
- Salin tag iklan ke kolom URL browser web (misalnya, Chrome) dan verifikasi bahwa tag tersebut menampilkan respons VAST yang tidak kosong. Berikut adalah respons VAST kosong:
```
<VAST version="3.0"/>
```
- Jika respons VAST kosong ditampilkan, masalahnya adalah tag iklan. Pastikan tag iklan disiapkan dengan benar menggunakan server iklan.
- Jika respons VAST terisi, gunakan curl untuk meminta tag iklan. Beberapa server iklan memerlukan header User-Agent. Coba perintah curl berikut:
```
curl AD_TAG_URI
```
- Jika perintah curl menampilkan respons VAST kosong, tambahkan header User-Agent ke perintah curl:
```
curl -H "User-Agent: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36" \
    AD_TAG_URI
```
- Jika respons VAST terisi ditampilkan, masalahnya adalah header User-Agent harus diteruskan ke Video Stitcher API saat membuat sesi live. Video Stitcher API menggunakan header tersebut saat menjalankan tag iklan untuk mengambil iklan.
- Jika respons kosong masih ditampilkan, berarti masalahnya ada pada tag iklan yang diberikan. Konfirmasi dengan pelanggan bahwa tag iklan sudah benar dan nilai makro tag iklan juga sudah benar.
- Jika masalah tag iklan pelanggan telah diselesaikan, tetapi iklan belum disisipkan, lanjutkan ke langkah berikutnya.
Periksa sesi live. Jika sesi yang terpengaruh menunjukkan bahwa iklan ditampilkan dari server iklan, lanjutkan ke langkah berikutnya.
Potensi penyebab berikutnya tidak adanya iklan adalah karena encoding ulang iklan. API akan mengenkode ulang iklan selama pertemuan pertamanya untuk mengenkode iklan agar cocok dengan video sumber. Biasanya, iklan memerlukan waktu beberapa menit untuk dienkode. Coba lagi membuat sesi baru setelah beberapa menit untuk melihat apakah iklan sudah disisipkan.

Jika tidak ada iklan yang disisipkan, masalah ini mungkin disebabkan oleh iklan yang gagal dienkode. URL media iklan mungkin tidak dapat dijangkau. Dalam hal ini, pelanggan harus bekerja sama dengan penyedia iklan untuk menentukan masalah yang terjadi pada media iklan mereka.

Tidak ada iklan yang disisipkan dalam sesi VOD

Pastikan tag iklan yang diberikan menampilkan respons VAST atau VMAP yang tidak kosong. Gunakan tag iklan yang diberikan dengan petunjuk berikut:
- Salin tag iklan ke kolom URL browser web (misalnya, Chrome) dan verifikasi bahwa tag tersebut menampilkan respons VAST, VMAP, atau SmartXML yang tidak kosong. Berikut adalah respons VAST kosong:
- Masukkan tag iklan ke dalam browser web (yaitu Kolom URL Chrome, Firefox, dll.) dan memverifikasi bahwa URL menampilkan respons VAST, VMAP, atau SmartXML yang tidak kosong. Respons VAST kosong akan terlihat seperti ini:
```
<VAST version="3.0"/>
```
  Berikut ini adalah respons VMAP kosong:
```
<VMAP xmlns:vmap="http://www.iab.net/vmap-1.0" version="1.0"/>
```
- Jika respons VAST kosong ditampilkan, masalahnya adalah tag iklan. Pastikan tag iklan disiapkan dengan benar menggunakan server iklan.
- Jika respons VAST terisi, gunakan curl untuk meminta tag iklan. Beberapa server iklan memerlukan header User-Agent. Coba perintah curl berikut:
```
curl AD_TAG_URI
```
- Jika perintah curl menampilkan respons VAST kosong, tambahkan header User-Agent ke perintah curl:
```
curl -H "User-Agent: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36" \
    AD_TAG_URI
```
- Jika respons VAST atau VMAP terisi ditampilkan, masalahnya adalah header User-Agent harus diteruskan ke Video Stitcher API saat membuat sesi VOD. Video Stitcher API menggunakan header tersebut saat menjalankan tag iklan untuk mengambil iklan.
- Jika respons kosong masih ditampilkan, berarti masalahnya ada pada tag iklan yang diberikan. Konfirmasi dengan pelanggan bahwa tag iklan sudah benar dan nilai makro tag iklan juga sudah benar.
- Jika masalah tag iklan pelanggan telah diselesaikan, tetapi iklan belum disisipkan, lanjutkan ke langkah berikutnya.
Periksa sesi VOD. Jika sesi yang terpengaruh menunjukkan bahwa iklan ditampilkan dari server iklan, lanjutkan ke langkah berikutnya.
Potensi penyebab berikutnya tidak adanya iklan adalah karena encoding ulang iklan. API akan mengenkode ulang iklan selama pertemuan pertamanya untuk mengenkode iklan agar cocok dengan video sumber. Biasanya, iklan memerlukan waktu beberapa menit untuk dienkode. Coba lagi membuat sesi baru setelah beberapa menit untuk melihat apakah iklan sudah disisipkan.

Jika tidak ada iklan yang disisipkan, masalah ini mungkin disebabkan oleh iklan yang gagal dienkode. URL media iklan mungkin tidak dapat dijangkau. Dalam hal ini, pelanggan harus bekerja sama dengan penyedia iklan untuk menentukan masalah yang terjadi pada media iklan mereka.