Untuk mengaktifkan Video Stitcher API untuk project Anda, hubungi Account Representative atau hubungi Sales untuk mempelajari lebih lanjut.

Halaman ini diterjemahkan oleh Cloud Translation API.

Memecahkan masalah

Halaman ini menunjukkan cara menyelesaikan masalah terkait 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 mengatasi masalah ini, ikuti langkah-langkah di bawah:

Pastikan sourceUri yang diberikan tertaut ke manifes video yang valid.
- Gunakan curl dengan sourceUri. Jika manifes dimaksudkan untuk dapat diakses secara publik, pastikan URL 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 yang cocok dengan nama host sourceUri ada. Jika konfigurasi tidak ada, daftarkan kunci CDN dengan Video Stitcher API. Tunggu setidaknya 5 menit hingga konfigurasi diterapkan ke layanan.
- Jika konfigurasi sudah ada, lanjutkan ke langkah berikutnya.
Jika Anda mencurigai kunci pribadi yang digunakan untuk menandatangani URL salah, sebaiknya perbarui kunci CDN terdaftar dengan kunci pribadi yang benar.

Kunci CDN sudah tidak berlaku

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

Jika kunci CDN baru saja didaftarkan dengan Video Stitcher API, tunggu setidaknya 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 tidak digunakan lagi.

Tidak ada iklan yang disisipkan dalam sesi live

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

Pastikan live stream sumber menyisipkan jeda iklan dalam manifes. Penanda iklan berikut harus ada dalam manifes video live stream untuk menunjukkan kepada Video Stitcher API agar mengganti segmen video sumber dengan segmen iklan.
- Jika manifes video sumber tidak memiliki penanda iklan, encoder Anda 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 di server iklan.
- Jika respons VAST diisi, gunakan curl untuk meminta tag iklan. Beberapa server iklan mewajibkan header User-Agent disediakan. 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 yang 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. Konfirmasikan dengan pelanggan bahwa tag iklan sudah benar dan nilai makro tag iklan juga sudah benar.
- Jika masalah tag iklan pelanggan telah teratasi, 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.
Penyebab potensial berikutnya untuk iklan yang tidak ada adalah karena enkode 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 disisipkan.

Jika tidak ada iklan yang disisipkan, masalahnya mungkin karena iklan gagal dienkode. URL media iklan mungkin tidak dapat dijangkau. Dalam hal ini, pelanggan perlu bekerja sama dengan penyedia iklan untuk menentukan masalah 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 browser web (yaitu Chrome, Firefox, dll.) dan memverifikasi bahwa browser menampilkan respons VAST, VMAP, atau SmartXML yang tidak kosong. Respons VAST kosong akan terlihat seperti ini:
```
<VAST version="3.0"/>
```
  Berikut 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 di server iklan.
- Jika respons VAST diisi, gunakan curl untuk meminta tag iklan. Beberapa server iklan mewajibkan header User-Agent disediakan. 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 yang 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. Konfirmasikan dengan pelanggan bahwa tag iklan sudah benar dan nilai makro tag iklan juga sudah benar.
- Jika masalah tag iklan pelanggan telah teratasi, 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.
Penyebab potensial berikutnya untuk iklan yang tidak ada adalah karena enkode 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 disisipkan.

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