Fehler beheben

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:

  1. 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 das Videomanifest eine URL-Signatur erfordert, fahre mit dem nächsten Schritt fort.

  2. Der CDN-Schlüssel muss bei der Video Stitcher API in derselben Region wie die Anfrage registriert sein.

  3. 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:

  1. 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.

  2. 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.

In einer Live-Sitzung wurden keine Anzeigen eingefügt.

Wenn in einer Livestream-Sitzung keine Anzeigen eingefügt wurden, gehe so vor, um das Problem zu diagnostizieren:

  1. 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.

  2. 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:

      <VAST version="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-Agent Header angegeben werden. Führen Sie folgenden curl-Befehl aus:

      curl AD_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.

  3. 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.

  4. 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.

In einer VOD-Sitzung wurden keine Anzeigen eingefügt.

  1. 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üft, ob eine nicht leere VAST-, VMAP- oder SmartXML-Antwort zurückgegeben wird. Eine leere VAST-Antwort sieht so aus:

      <VAST version="3.0"/>

      Im Folgenden finden Sie eine leere VMAP-Antwort:

      <VMAP xmlns:vmap="http://www.iab.net/vmap-1.0" version="1.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-Agent Header angegeben werden. Führen Sie folgenden curl-Befehl aus:

      curl AD_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.

  2. 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.

  3. 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.