Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
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 terdaftar 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.
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:
<VASTversion="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 headerUser-Agent
disediakan. Coba perintah curl berikut:
curlAD_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 respons yang ditampilkan bukan respons VAST, VMAP, atau SmartXML kosong. Respons VAST kosong akan terlihat seperti ini:
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 headerUser-Agent
disediakan. Coba perintah curl berikut:
curlAD_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.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-09-04 UTC."],[],[],null,["# Troubleshoot\n\nThis page shows you how to resolve issues with the Video Stitcher API. The errors\nshown on this page are specific to the Video Stitcher API. For information on\ngeneric errors across Google APIs, see the Cloud APIs\n[Errors](/apis/design/errors) page.\n\nOnly the first error is returned. If a request encounters multiple errors, you\nneed to fix the returned error and retry the request to see the next error.\n\nUnable to fetch playlist when creating a session\n------------------------------------------------\n\nThe following issue occurs when the Video Stitcher API is unable to fetch the\nvideo manifest from the specified `sourceUri`. \n\n```\n{\n \"error\": {\n \"code\": 404,\n \"message\": \"got status code 403 when fetching playlist from URI \\\"https://example.com/manifest.m3u8\\\"\",\n \"status\": \"NOT_FOUND\",\n }\n}\n```\n\nTo resolve this issue, follow the steps below:\n\n1. Verify that the provided `sourceUri` links to a valid video manifest.\n\n - Use `curl` with the `sourceUri`. If the manifest is intended to be publicly accessible, ensure that the URL can be reached publicly.\n - If the `sourceUri` is correct and the video manifest requires URL signing, proceed to the next step.\n2. Ensure that the CDN key has been registered with the Video Stitcher API in the\n same region as the request.\n\n - [Verify that the CDN key configuration](/video-stitcher/docs/how-to/managing-cdn-keys#list_cdn_keys) matching the `sourceUri` hostname exists. If the configuration doesn't exist, [register the CDN key](/video-stitcher/docs/how-to/managing-cdn-keys#register_cdn_key) with the Video Stitcher API. Wait at least 5 minutes for the configuration to propagate to the service.\n - If the configuration exists, proceed to the next step.\n3. If you suspect the private key used for signing the URL is incorrect, you\n may want to\n [update the registered CDN key](/video-stitcher/docs/how-to/managing-cdn-keys#update_cdn_key)\n with the correct private key.\n\nCDN key is outdated\n-------------------\n\nIf you recently registered or updated a CDN key and the Video Stitcher API has not\nstarted signing URLs using the new configuration, then follow the steps below to\ndiagnose the issue:\n\n1. If the CDN key was recently registered with the Video Stitcher API, then wait\n at least 5 minutes to allow the update to propagate. If the issue persist,\n proceed to the next step.\n\n2. Verify that only one CDN key is registered for one hostname for the region.\n If multiple CDN keys have been registered with the same hostname, the\n Video Stitcher API will select one of the CDN keys to sign the URL with.\n\n - Ensure that only one CDN key has been registered with a specified hostname for a given region. [Delete the obsolete CDN key](/video-stitcher/docs/how-to/managing-cdn-keys#delete_cdn_key).\n\nNo ads inserted in a live session\n---------------------------------\n\nIf no ads were inserted in a live session, use the following steps to diagnose\nthe issue:\n\n1. Verify that the source livestreams inserted ad breaks in the manifest. The\n following [ad markers](/video-stitcher/docs/concepts/ad-markers) need to\n exist in the livestream video manifest to indicate to the Video Stitcher API\n to replace source video segments with ad segments.\n\n - If the source video manifest does not have any ad markers, either your\n encoder hasn't triggered an ad break or needs to be changed to insert\n the supported [ad markers](/video-stitcher/docs/concepts/ad-markers).\n\n - If ad markers are clearly visible in the source manifest, then proceed\n to the next step.\n\n2. Verify that the provided ad tag returns a non-empty VAST response.\n\n - Copy the ad tag into a web browser (for example, Chrome) address bar and\n verifies that it returns a non-empty VAST response. The following is an\n empty VAST response:\n\n \u003cVAST version=\"3.0\"/\u003e\n\n - If an empty VAST response is returned, then the issue is the ad tag.\n Verify that the ad tag is set up correctly with the ad servers.\n\n - If the VAST response is populated, use `curl` to request the ad tag.\n Some ad servers require the `User-Agent`\n [header](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/User-Agent)\n to be provided. Try the following `curl` command:\n\n curl \u003cvar translate=\"no\"\u003eAD_TAG_URI\u003c/var\u003e\n\n - If the `curl` command returns an empty VAST response, add the\n `User-Agent` header to the `curl` command:\n\n 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\" \\\n \u003cvar translate=\"no\"\u003eAD_TAG_URI\u003c/var\u003e\n\n - If a populated VAST response is returned, then the issue is that the\n `User-Agent` header needs to be passed to the Video Stitcher API when\n creating the live session. The Video Stitcher API uses that header when\n executing the ad tag to retrieve ads.\n\n - If an empty response is still returned, then the issue is with the given\n ad tag. Confirm with the customer that the ad tag is correct and that\n any\n [ad tag macro](/video-stitcher/docs/how-to/managing-live-sessions#ad-tag-macros)\n values are correct as well.\n\n - If the customer's ad tag issues have been resolved, but ads have not\n been inserted, proceed to the next step.\n\n3. [Inspect the live session](/video-stitcher/docs/how-to/managing-live-sessions#inspect-live-sessions).\n If the affected session is showing that ads are returned from the ad\n servers, then proceed to the next step.\n\n4. The next potential cause for missing ads is due to\n [ad re-encoding](/video-stitcher/docs/concepts/overview#ad_re-encoding). The\n API will re-encode ads during its first encounter to encode the ad to match\n the source video. Usually, ads take a few minutes to encode. Retry creating\n a new session after a few minutes to see if ads are inserted.\n\n If no ads were inserted, the issue may be due to an ad failing to encode.\n The ad media URLs may not be reachable. In this case, the customer needs to\n work with the ad provider to determine what's wrong with their ad media.\n\nNo ads inserted in a VOD session\n--------------------------------\n\n1. Verify that the provided ad tag returns a non-empty VAST or VMAP response.\n Use the provided ad tag with the following directions:\n\n - Copy the ad tag into a web browser (for example, Chrome) address bar and verifies that it returns a non-empty VAST, VMAP, or SmartXML response. The following is an empty VAST response:\n - Put the ad tag into a web browser (ie. Chrome, Firefox, etc) address bar\n and verifies that it returns a non empty VAST, VMAP, or SmartXML\n response. An empty VAST response looks like:\n\n \u003cVAST version=\"3.0\"/\u003e\n\n The following is an empty VMAP response: \n\n \u003cVMAP xmlns:vmap=\"http://www.iab.net/vmap-1.0\" version=\"1.0\"/\u003e\n\n - If an empty VAST response is returned, then the issue is the ad tag.\n Verify that the ad tag is set up correctly with the ad servers.\n\n - If the VAST response is populated, use `curl` to request the ad tag.\n Some ad servers require the `User-Agent`\n [header](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/User-Agent)\n to be provided. Try the following `curl` command:\n\n curl \u003cvar translate=\"no\"\u003eAD_TAG_URI\u003c/var\u003e\n\n - If the `curl` command returns an empty VAST response, add the\n `User-Agent` header to the `curl` command:\n\n 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\" \\\n \u003cvar translate=\"no\"\u003eAD_TAG_URI\u003c/var\u003e\n\n - If a populated VAST or VMAP response is returned, then the issue is that\n the `User-Agent` header needs to be passed to the Video Stitcher API\n when creating the VOD session. The Video Stitcher API uses that header\n when executing the ad tag to retrieve ads.\n\n - If an empty response is still returned, then the issue is with the given\n ad tag. Confirm with the customer that the ad tag is correct and that\n any\n [ad tag macro](/video-stitcher/docs/how-to/managing-vod-sessions#ad-tag-macros)\n values are correct as well.\n\n - If the customer's ad tag issues have been resolved, but ads have not\n been inserted, proceed to the next step.\n\n2. [Inspect the VOD session](/video-stitcher/docs/how-to/managing-vod-sessions#inspect-vod-sessions).\n If the affected session is showing that ads are returned from the ad\n servers, then proceed to the next step.\n\n3. The next potential cause for missing ads is due to\n [ad re-encoding](/video-stitcher/docs/concepts/overview#ad_re-encoding). The\n API will re-encode ads during its first encounter to encode the ad to match\n the source video. Usually, ads take a few minutes to encode. Retry creating\n a new session after a few minutes to see if ads are inserted.\n\n If no ads were inserted, the issue may be due to an ad failing to encode.\n The ad media URLs may not be reachable. In this case, the customer needs to\n work with the ad provider to determine what's wrong with their ad media."]]
