Wenn Sie die Video Stitcher API für Ihr Projekt aktivieren möchten, wenden Sie sich an Ihren Kundenbetreuer oder an den Vertrieb, um weitere Informationen zu erhalten.

Diese Seite wurde von der Cloud Translation API übersetzt.

Fehler beheben

Auf dieser Seite erfahren Sie, wie Sie Probleme mit der Video Stitcher API beheben. Fehler die auf dieser Seite beschrieben werden, für die Video Stitcher API spezifisch sind. 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:

Die angegebene sourceUri muss auf ein gültiges Videomanifest verweisen.
- 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.
- Prüfen, ob die CDN-Schlüsselkonfiguration für den Hostnamen sourceUri vorhanden ist. Wenn die Konfiguration nicht vorhanden ist, registriere den CDN-Schlüssel bei der Video Stitcher API. Warten Sie mindestens 5 Minuten für die Konfiguration an den Dienst weitergegeben werden soll.
- 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 Sie vor Kurzem einen CDN-Schlüssel registriert oder aktualisiert haben und die Video Stitcher API nicht Signieren von URLs mit der neuen Konfiguration. Gehen Sie dann wie unten beschrieben vor, um das Problem zu diagnostizieren:

Wenn der CDN-Schlüssel vor Kurzem bei der Video Stitcher API registriert wurde, warten Sie mindestens 5 Minuten, damit die Aktualisierung wirksam wird. Wenn das Problem weiterhin besteht, fahren Sie 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, wird der Parameter Die Video Stitcher API wählt einen der CDN-Schlüssel zum Signieren der URL aus.
- Achten Sie darauf, dass nur ein CDN-Schlüssel mit einem angegebenen Hostname für eine bestimmte Region. Lösche den veralteten CDN-Schlüssel.

Keine Anzeigen in einer Livesitzung eingefügt

Wenn in einer Livestream-Sitzung keine Anzeigen eingefügt wurden, führe die folgenden Schritte aus, um das Problem zu 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 deutlich sichtbar sind, fahren Sie fort mit dem nächsten Schritt fortfahren.
Ü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 überprüft, ob eine VAST-Antwort zurückgegeben wird, die nicht leer ist. Im Folgenden finden Sie 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. 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 den Parameter User-Agent dem Befehl curl 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, ist das Problem, Der Header User-Agent muss an die Video Stitcher API übergeben werden, wenn während der Live-Sitzung erstellt wird. Die Video Stitcher API verwendet diesen Header, wenn das Anzeigen-Tag ausgeführt wird, 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 Livesitzung. 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 Neucodierung von Anzeigen. Die Die API codiert Anzeigen bei der ersten Begegnung neu, um die Anzeige entsprechend zu codieren. das Quellvideo. Normalerweise dauert die Codierung von Anzeigen einige Minuten. Erstellung wiederholen nach einigen Minuten eine neue Sitzung an, 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 Sie arbeiten mit dem Anzeigenanbieter zusammen, um das Problem mit seinen Anzeigenmedien zu ermitteln.

Keine Anzeigen in einer VOD-Sitzung 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 wie folgt:
- Kopieren Sie das Anzeigen-Tag in die Adressleiste eines Webbrowsers (z. B. Chrome) und überprüft, 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:
```
<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. Für einige Ad-Server ist das Attribut User-Agent erforderlich header bereitgestellt 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, ist das Problem, Der Header User-Agent muss an die Video Stitcher API übergeben werden. wenn die VOD-Sitzung erstellt wird. 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 Neucodierung von Anzeigen. Die API codiert Anzeigen bei der ersten Begegnung neu, damit sie mit dem Quellvideo übereinstimmen. Das Codieren der Anzeigen dauert in der Regel ein paar Minuten. Erstellung wiederholen nach einigen Minuten eine neue Sitzung an, um zu sehen, ob Anzeigen eingefügt werden.

Wenn keine Anzeigen eingefügt wurden, kann das Problem daran liegen, 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.