Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Auf dieser Seite erfahren Sie, wie Sie Probleme mit der Video Stitcher API beheben. Die auf dieser Seite angezeigten Fehler gelten speziell für die Video Stitcher API. Informationen zu generischen Fehlern in Google APIs finden Sie auf der Seite Cloud APIs – Fehler.
Es wird nur der erste Fehler zurückgegeben. Wenn bei einer Anfrage mehrere Fehler auftreten, müssen Sie den zurückgegebenen Fehler beheben und die Anfrage noch einmal ausführen, um den nächsten Fehler zu sehen.
Playlist kann beim Erstellen einer Sitzung nicht abgerufen werden
Das folgende Problem tritt auf, wenn die Video Stitcher API das Videomanifest nicht von der angegebenen sourceUri abrufen kann.
{
"error": {
"code": 404,
"message": "got status code 403 when fetching playlist from URI \"https://example.com/manifest.m3u8\"",
"status": "NOT_FOUND",
}
}
Gehen Sie so vor, um dieses Problem zu beheben:
Prüfe, ob die angegebene sourceUri mit einem gültigen Videomanifest verknüpft ist.
Verwenden Sie curl mit sourceUri. Wenn das Manifest öffentlich zugänglich sein soll, muss die URL öffentlich zugänglich sein.
Wenn die sourceUri korrekt ist und für das Videomanifest eine URL-Signatur erforderlich ist, fahre mit dem nächsten Schritt fort.
Der CDN-Schlüssel muss bei der Video Stitcher API in derselben Region wie die Anfrage registriert sein.
Wenn die Konfiguration vorhanden ist, fahren Sie mit dem nächsten Schritt fort.
Wenn Sie vermuten, dass der zum Signieren der URL verwendete private Schlüssel falsch ist, können Sie den registrierten CDN-Schlüssel mit dem richtigen privaten Schlüssel aktualisieren.
CDN-Schlüssel ist veraltet
Wenn du vor Kurzem einen CDN-Schlüssel registriert oder aktualisiert hast und die Video Stitcher API URLs nicht mit der neuen Konfiguration signiert, führe die folgenden Schritte aus, um das Problem zu diagnostizieren:
Wenn der CDN-Schlüssel vor Kurzem bei der Video Stitcher API registriert wurde, warte mindestens 5 Minuten, damit die Aktualisierung übernommen werden kann. Falls das Problem weiterhin auftritt, fahre mit dem nächsten Schritt fort.
Prüfen Sie, ob für einen Hostnamen in der Region nur ein CDN-Schlüssel registriert ist.
Wenn mehrere CDN-Schlüssel mit demselben Hostnamen registriert wurden, wählt die Video Stitcher API einen der CDN-Schlüssel aus, mit dem die URL signiert werden soll.
Achten Sie darauf, dass für eine bestimmte Region nur ein CDN-Schlüssel mit einem bestimmten Hostnamen registriert ist.
Lösche den veralteten CDN-Schlüssel.
In einer Live-Sitzung wurden keine Anzeigen eingefügt.
Wenn in einer Livestream-Sitzung keine Anzeigen eingefügt wurden, kannst du das Problem so diagnostizieren:
Prüfe, ob in den Quell-Livestreams Werbeunterbrechungen in das Manifest eingefügt wurden. Die folgenden Anzeigenmarkierungen müssen im Manifest des Livestream-Videos vorhanden sein, um der Video Stitcher API anzugeben, dass Quellvideosegmente durch Anzeigensegmente ersetzt werden sollen.
Wenn das Manifest des Quellvideos keine Anzeigenmarkierungen enthält, hat dein Encoder entweder keine Werbeunterbrechung ausgelöst oder muss so geändert werden, dass die unterstützten Anzeigenmarkierungen eingefügt werden.
Wenn die Anzeigenmarkierungen im Quellmanifest gut sichtbar sind, fahren Sie mit dem nächsten Schritt fort.
Prüfen Sie, ob das angegebene Anzeigen-Tag eine nicht leere VAST-Antwort zurückgibt.
Kopieren Sie das Anzeigen-Tag in die Adressleiste eines Webbrowsers (z. B. Chrome) und prüfen Sie, ob eine nicht leere VAST-Antwort zurückgegeben wird. Hier ist eine leere VAST-Antwort:
<VASTversion="3.0"/>
Wenn eine leere VAST-Antwort zurückgegeben wird, liegt das Problem am Anzeigen-Tag.
Prüfen Sie, ob das Anzeigen-Tag richtig mit den Anzeigenservern eingerichtet ist.
Wenn die VAST-Antwort ausgefüllt ist, verwenden Sie curl, um das Anzeigen-Tag anzufordern.
Bei einigen Ad-Servern muss der User-AgentHeader angegeben werden. Probieren Sie den folgenden curl-Befehl aus:
curlAD_TAG_URI
Wenn der Befehl curl eine leere VAST-Antwort zurückgibt, fügen Sie dem Befehl curl den Header User-Agent hinzu:
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
Wenn eine ausgefüllte VAST-Antwort zurückgegeben wird, liegt das Problem daran, dass der User-Agent-Header beim Erstellen der Livestream-Sitzung an die Video Stitcher API übergeben werden muss. Die Video Stitcher API verwendet diesen Header beim Ausführen des Anzeigen-Tags, um Anzeigen abzurufen.
Wenn weiterhin eine leere Antwort zurückgegeben wird, liegt das Problem am jeweiligen Anzeigen-Tag. Fragen Sie den Kunden, ob das Anzeigen-Tag und alle Werte des Anzeigen-Tag-Makros korrekt sind.
Wenn die Probleme mit dem Anzeigen-Tag des Kunden behoben wurden, aber keine Anzeigen eingefügt wurden, fahren Sie mit dem nächsten Schritt fort.
Prüfen Sie die Live-Sitzung.
Wenn in der betroffenen Sitzung angezeigt wird, dass Anzeigen von den Anzeigenservern zurückgegeben werden, fahren Sie mit dem nächsten Schritt fort.
Die nächste mögliche Ursache für fehlende Anzeigen ist das Wiedercodieren von Anzeigen. Die API codiert Anzeigen bei der ersten Begegnung neu, damit sie dem Quellvideo entsprechen. Normalerweise dauert die Codierung von Anzeigen einige Minuten. Versuchen Sie nach einigen Minuten noch einmal, eine neue Sitzung zu erstellen, um zu sehen, ob Anzeigen eingefügt werden.
Wenn keine Anzeigen eingefügt wurden, liegt das Problem möglicherweise daran, dass eine Anzeige nicht codiert werden konnte.
Die URLs der Anzeigenmedien sind möglicherweise nicht erreichbar. In diesem Fall muss der Kunde mit dem Anzeigenanbieter zusammenarbeiten, um das Problem mit seinen Anzeigenmedien zu ermitteln.
In einer VOD-Sitzung wurden keine Anzeigen eingefügt.
Prüfen Sie, ob das bereitgestellte Anzeigen-Tag eine nicht leere VAST- oder VMAP-Antwort zurückgibt.
Verwenden Sie das bereitgestellte Anzeigen-Tag gemäß der folgenden Anleitung:
Kopieren Sie das Anzeigen-Tag in die Adressleiste eines Webbrowsers (z. B. Chrome) und prüfen Sie, ob eine nicht leere VAST-, VMAP- oder SmartXML-Antwort zurückgegeben wird.
Im Folgenden finden Sie eine leere VAST-Antwort:
Fügen Sie das Anzeigen-Tag in einen Webbrowser ein (z. B. (z. B. Chrome oder Firefox) und prüfen, ob eine nicht leere VAST-, VMAP- oder SmartXML-Antwort zurückgegeben wird. Eine leere VAST-Antwort sieht so aus:
Wenn eine leere VAST-Antwort zurückgegeben wird, liegt das Problem am Anzeigen-Tag.
Prüfen Sie, ob das Anzeigen-Tag richtig mit den Anzeigenservern eingerichtet ist.
Wenn die VAST-Antwort ausgefüllt ist, verwenden Sie curl, um das Anzeigen-Tag anzufordern.
Bei einigen Ad-Servern muss der User-AgentHeader angegeben werden. Führen Sie folgenden curl-Befehl aus:
curlAD_TAG_URI
Wenn der Befehl curl eine leere VAST-Antwort zurückgibt, fügen Sie dem Befehl curl den Header User-Agent hinzu:
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
Wenn eine ausgefüllte VAST- oder VMAP-Antwort zurückgegeben wird, liegt das Problem daran, dass der User-Agent-Header beim Erstellen der VOD-Sitzung an die Video Stitcher API übergeben werden muss. Die Video Stitcher API verwendet diesen Header beim Ausführen des Anzeigen-Tags, um Anzeigen abzurufen.
Wenn weiterhin eine leere Antwort zurückgegeben wird, liegt das Problem am jeweiligen Anzeigen-Tag. Fragen Sie den Kunden, ob das Anzeigen-Tag und alle Werte des Anzeigen-Tag-Makros korrekt sind.
Wenn die Probleme mit dem Anzeigen-Tag des Kunden behoben wurden, aber keine Anzeigen eingefügt wurden, fahren Sie mit dem nächsten Schritt fort.
Prüfen Sie die VOD-Sitzung.
Wenn in der betroffenen Sitzung angezeigt wird, dass Anzeigen von den Anzeigenservern zurückgegeben werden, fahren Sie mit dem nächsten Schritt fort.
Die nächste mögliche Ursache für fehlende Anzeigen ist das Wiedercodieren von Anzeigen. Die API codiert Anzeigen bei der ersten Begegnung neu, damit sie mit dem Quellvideo übereinstimmen. Normalerweise dauert die Codierung von Anzeigen einige Minuten. Versuchen Sie nach einigen Minuten noch einmal, eine neue Sitzung zu erstellen, um zu sehen, ob Anzeigen eingefügt werden.
Wenn keine Anzeigen eingefügt wurden, liegt das Problem möglicherweise daran, dass eine Anzeige nicht codiert werden konnte.
Die URLs der Anzeigenmedien sind möglicherweise nicht erreichbar. In diesem Fall muss der Kunde mit dem Anzeigenanbieter zusammenarbeiten, um das Problem mit seinen Anzeigenmedien zu ermitteln.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 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."]]
