Fehler beheben

Auf dieser Seite erfahren Sie, wie Sie Probleme mit der Video Stitcher API beheben. Die auf dieser Seite aufgeführten Fehler beziehen sich speziell auf 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 wiederholen, 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 aus dem angegebenen sourceUri nicht abrufen kann.

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

So beheben Sie das Problem:

  1. Die angegebene sourceUri muss auf ein gültiges Videomanifest verweisen.

    • curl mit sourceUri verwenden. Wenn das Manifest öffentlich zugänglich sein soll, muss die URL öffentlich zugänglich sein.
    • Wenn 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 private Schlüssel zum Signieren der URL falsch ist, können Sie den registrierten CDN-Schlüssel mit dem richtigen privaten Schlüssel aktualisieren.

Der CDN-Schlüssel ist veraltet

Wenn Sie vor Kurzem einen CDN-Schlüssel registriert oder aktualisiert haben und die Video Stitcher API nicht damit begonnen hat, URLs mit der neuen Konfiguration zu signieren, gehen Sie so vor, um das Problem zu diagnostizieren:

  1. Wenn der CDN-Schlüssel vor Kurzem bei der Video Stitcher API registriert wurde, warten Sie mindestens 5 Minuten, bis die Aktualisierung übernommen wurde. Wenn das Problem weiterhin besteht, fahren Sie mit dem nächsten Schritt fort.

  2. Achten Sie darauf, dass nur ein CDN-Schlüssel für einen Hostnamen für die Region registriert ist. Wenn mehrere CDN-Schlüssel mit demselben Hostnamen registriert wurden, wählt die Video Stitcher API einen der CDN-Schlüssel zum Signieren der URL aus.

Keine Anzeigen in einer Livesitzung eingefügt

Wenn in einer Livesitzung keine Anzeigen eingefügt wurden, können Sie das Problem mithilfe der folgenden Schritte diagnostizieren:

  1. Prüfe, ob die Quelle die eingefügten Werbeunterbrechungen im Manifest live abspielt. Die folgenden Anzeigenmarkierungen müssen im Manifest des Livestream-Videos vorhanden sein, um der Video Stitcher API mitzuteilen, dass Quellvideosegmente durch Anzeigensegmente ersetzt werden sollen.

    • Wenn das Quellvideomanifest keine Anzeigenmarkierungen enthält, hat der 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 deutlich sichtbar sind, fahren Sie mit dem nächsten Schritt fort.

  2. Überprüfen Sie, ob das bereitgestellte 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 VAST-Antwort zurückgegeben wird, die nicht leer ist. Im Folgenden sehen Sie eine leere VAST-Antwort:

      <VAST version="3.0"/>

    • Wenn eine leere VAST-Antwort zurückgegeben wird, liegt das Problem am Anzeigen-Tag. Überprüfen Sie, ob das Anzeigen-Tag korrekt mit den Ad Servern eingerichtet wurde.

    • Wenn die VAST-Antwort ausgefüllt ist, verwenden Sie curl, um das Anzeigen-Tag anzufordern. Bei einigen Ad-Servern muss der Header User-Agent angegeben werden. Versuchen Sie es mit dem folgenden curl-Befehl:

      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, muss der Header User-Agent beim Erstellen der Livesitzung an die Video Stitcher API übergeben werden. Die Video Stitcher API verwendet diesen Header, wenn das Anzeigen-Tag zum Abrufen von Anzeigen ausgeführt wird.

    • Wird weiterhin eine leere Antwort zurückgegeben, liegt das Problem beim angegebenen Anzeigen-Tag. Lassen Sie sich vom Kunden bestätigen, dass das Anzeigen-Tag korrekt ist und ob auch die Werte des Anzeigen-Tag-Makros korrekt sind.

    • Wenn die Probleme mit den Anzeigen-Tags des Kunden behoben wurden, aber keine Anzeigen eingefügt wurden, fahren Sie mit dem nächsten Schritt fort.

  3. Prüfen Sie die Livesitzung. Wenn in der betroffenen Sitzung angezeigt wird, dass Anzeigen von den Ad-Servern zurückgegeben werden, fahren Sie mit dem nächsten Schritt fort.

  4. Die nächste mögliche Ursache für fehlende Anzeigen ist die Neucodierung von Anzeigen. Die API codiert Anzeigen bei der ersten Übereinstimmung neu, um sie so zu codieren, dass sie mit dem Quellvideo übereinstimmt. Das Codieren der Anzeigen dauert in der Regel ein paar Minuten. Versuchen Sie nach einigen Minuten noch einmal, eine neue Sitzung zu erstellen, um zu sehen, ob Anzeigen eingefügt wurden.

    Wenn keine Anzeigen eingefügt wurden, kann das Problem daran liegen, dass eine Anzeige nicht codiert werden konnte. Die Anzeigenmedien-URLs sind möglicherweise nicht erreichbar. In diesem Fall muss der Kunde mit dem Anzeigenanbieter zusammenarbeiten, um herauszufinden, was mit seinen Anzeigenmedien nicht stimmt.

Keine Anzeigen in einer VOD-Sitzung eingefügt

  1. Überprüfen Sie, ob das bereitgestellte Anzeigen-Tag eine nicht leere VAST- oder VMAP-Antwort zurückgibt. Verwenden Sie das bereitgestellte Anzeigen-Tag wie folgt:

    • 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 sehen Sie eine leere VAST-Antwort:

    • Fügen Sie das Anzeigen-Tag in einen Webbrowser ein (d. h. Chrome, Firefox usw.) und prüft, ob sie eine nicht leere VAST-, VMAP- oder SmartXML-Antwort zurückgibt. Eine leere VAST-Antwort sieht so aus:

      <VAST version="3.0"/>

      Im Folgenden sehen 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. Überprüfen Sie, ob das Anzeigen-Tag korrekt mit den Ad Servern eingerichtet wurde.

    • Wenn die VAST-Antwort ausgefüllt ist, verwenden Sie curl, um das Anzeigen-Tag anzufordern. Bei einigen Ad-Servern muss der Header User-Agent angegeben werden. Versuchen Sie es mit dem folgenden curl-Befehl:

      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, besteht das Problem darin, dass der Header User-Agent beim Erstellen der VOD-Sitzung an die Video Stitcher API übergeben werden muss. Die Video Stitcher API verwendet diesen Header, wenn das Anzeigen-Tag zum Abrufen von Anzeigen ausgeführt wird.

    • Wird weiterhin eine leere Antwort zurückgegeben, liegt das Problem beim angegebenen Anzeigen-Tag. Lassen Sie sich vom Kunden bestätigen, dass das Anzeigen-Tag korrekt ist und ob auch die Werte des Anzeigen-Tag-Makros korrekt sind.

    • Wenn die Probleme mit den Anzeigen-Tags 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 Ad-Servern zurückgegeben werden, fahren Sie mit dem nächsten Schritt fort.

  3. Die nächste mögliche Ursache für fehlende Anzeigen ist die Neucodierung von Anzeigen. Die API codiert Anzeigen bei der ersten Übereinstimmung neu, um sie so zu codieren, dass sie mit dem Quellvideo übereinstimmt. Das Codieren der Anzeigen dauert in der Regel ein paar Minuten. Versuchen Sie nach einigen Minuten noch einmal, eine neue Sitzung zu erstellen, um zu sehen, ob Anzeigen eingefügt wurden.

    Wenn keine Anzeigen eingefügt wurden, kann das Problem daran liegen, dass eine Anzeige nicht codiert werden konnte. Die Anzeigenmedien-URLs sind möglicherweise nicht erreichbar. In diesem Fall muss der Kunde mit dem Anzeigenanbieter zusammenarbeiten, um herauszufinden, was mit seinen Anzeigenmedien nicht stimmt.