Risolvere i problemi

Questa pagina mostra come risolvere i problemi relativi all'API Video Stitcher. Errori mostrati in questa pagina sono specifici dell'API Video Stitcher. Per informazioni sugli errori generici nelle API Google, consulta la pagina Errori delle API Cloud.

Viene restituito solo il primo errore. Se una richiesta rileva più errori, devi correggere l'errore restituito e riprovare a inviare la richiesta per visualizzare l'errore successivo.

Impossibile recuperare la playlist durante la creazione di una sessione

Il seguente problema si verifica quando l'API Video Stitcher non è in grado di recuperare il manifest video del sourceUri specificato.

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

Per risolvere il problema, procedi nel seguente modo:

  1. Verifica che il file sourceUri fornito rimandi a un manifest video valido.

    • Usa curl con sourceUri. Se il manifest deve essere accessibile pubblicamente, assicurati che l'URL sia raggiungibile pubblicamente.
    • Se il valore sourceUri è corretto e il manifest del video richiede la firma dell'URL, vai al passaggio successivo.

  2. Assicurati che la chiave CDN sia stata registrata con l'API Video Stitcher nella stessa regione della richiesta.

  3. Se sospetti che la chiave privata utilizzata per firmare l'URL non sia corretta, potresti volere aggiornare la chiave CDN registrata con la chiave privata corretta.

La chiave CDN è obsoleta

Se di recente hai registrato o aggiornato una chiave CDN e l'API Video Stitcher non ha iniziato a firmare gli URL utilizzando la nuova configurazione, segui i passaggi riportati di seguito per diagnosticare il problema:

  1. Se la chiave CDN è stata registrata di recente con l'API Video Stitcher, attendi almeno cinque minuti per consentire la propagazione dell'aggiornamento. Se il problema persiste, vai al passaggio successivo.

  2. Verifica che sia registrata una sola chiave CDN per un nome host per la regione. Se più chiavi CDN sono state registrate con lo stesso nome host, L'API Video Stitcher selezionerà una delle chiavi CDN con cui firmare l'URL.

Nessun annuncio inserito in una sessione dal vivo

Se non sono stati inseriti annunci in una sessione live, segui questi passaggi per diagnosticare il problema:

  1. Verifica che i live streaming di origine abbiano inserito le interruzioni pubblicitarie nel manifest. I seguenti indicatori di annuncio devono essere presenti nel manifest del video del live streaming per indicare all'API Video Stitcher di sostituire i segmenti video di origine con i segmenti di annunci.

    • Se il manifest del video sorgente non ha indicatori di annunci, il codificatore non ha attivato un'interruzione pubblicitaria o deve essere modificato per inserire Gli indicatori di annunci supportati.

    • Se gli indicatori degli annunci sono chiaramente visibili nel file manifest del codice sorgente, procedi al passaggio successivo.

  2. Verifica che il tag annuncio fornito restituisca una risposta VAST non vuota.

    • Copia il tag annuncio nella barra degli indirizzi di un browser web (ad es. Chrome) e verifica che restituisca una risposta VAST non vuota. Di seguito è riportata una risposta VAST vuota:

      <VAST version="3.0"/>

    • Se viene restituita una risposta VAST vuota, il problema riguarda il tag annuncio. Verifica che il tag annuncio sia configurato correttamente con gli ad server.

    • Se la risposta VAST è compilata, utilizza curl per richiedere il tag annuncio. Alcuni ad server richiedono User-Agent intestazione da fornire. Prova questo comando curl:

      curl AD_TAG_URI

    • Se il comando curl restituisce una risposta VAST vuota, aggiungi l'intestazione User-Agent al comando 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

    • Se viene restituita una risposta VAST compilata, il problema è che L'intestazione User-Agent deve essere passata all'API Video Stitcher quando la creazione della sessione dal vivo. L'API Video Stitcher utilizza questa intestazione durante l'esecuzione del tag annuncio per recuperare gli annunci.

    • Se viene comunque restituita una risposta vuota, il problema riguarda il tag annuncio specificato. Verifica con il cliente che il tag annuncio sia corretto e che qualsiasi macro tag annuncio sono corretti.

    • Se i problemi relativi ai tag annuncio del cliente sono stati risolti, ma gli annunci , vai al passaggio successivo.

  3. Esamina la sessione dal vivo. Se la sessione interessata mostra che gli annunci vengono restituiti dall'annuncio server, quindi vai al passaggio successivo.

  4. La causa successiva della mancata pubblicazione degli annunci è la ricodifica degli annunci. L'API ricoderà gli annunci durante il primo incontro per codificarli in modo che corrispondano al video di origine. In genere, la codifica degli annunci richiede alcuni minuti. Riprova a creare una nuova sessione dopo alcuni minuti per verificare se gli annunci sono stati inseriti.

    Se non sono stati inseriti annunci, il problema potrebbe essere dovuto alla mancata codifica di un annuncio. Gli URL multimediali degli annunci potrebbero non essere raggiungibili. In questo caso, il cliente deve collaborare con il fornitore di annunci per determinare il problema relativo ai contenuti multimediali dell'annuncio.

Nessun annuncio inserito in una sessione VOD

  1. Verifica che il tag annuncio fornito restituisca una risposta VAST o VMAP non vuota. Utilizza il tag annuncio fornito nel seguente modo:

    • Copia il tag annuncio nella barra degli indirizzi di un browser web (ad es. Chrome) e verifica che restituisca una risposta VAST, VMAP o SmartXML non vuota. Di seguito è riportata una risposta VAST vuota:

    • Inserisci il tag annuncio in un browser web (ad es. Chrome, Firefox e così via) e verifica che restituisca una risposta VAST, VMAP o SmartXML non vuota. Una risposta VAST vuota ha il seguente aspetto:

      <VAST version="3.0"/>

      Di seguito è riportata una risposta VMAP vuota:

      <VMAP xmlns:vmap="http://www.iab.net/vmap-1.0" version="1.0"/>

    • Se viene restituita una risposta VAST vuota, il problema riguarda il tag annuncio. Verifica che il tag annuncio sia configurato correttamente con gli ad server.

    • Se la risposta VAST è compilata, utilizza curl per richiedere il tag annuncio. Alcuni ad server richiedono l'User-Agent header . Prova il seguente comando curl:

      curl AD_TAG_URI

    • Se il comando curl restituisce una risposta VAST vuota, aggiungi l'intestazione User-Agent al comando 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

    • Se viene restituita una risposta VAST o VMAP compilata, il problema è che l'intestazione User-Agent deve essere passata all'API Video Stitcher durante la creazione della sessione VOD. L'API Video Stitcher utilizza questa intestazione quando esegue il tag annuncio per recuperare gli annunci.

    • Se viene comunque restituita una risposta vuota, il problema riguarda il tag annuncio specificato. Verifica con il cliente che il tag annuncio sia corretto e che qualsiasi macro tag annuncio sono corretti.

    • Se i problemi relativi ai tag annuncio del cliente sono stati risolti, ma gli annunci non sono stati inseriti, vai al passaggio successivo.

  2. Esamina la sessione VOD. Se la sessione interessata mostra che gli annunci vengono restituiti dall'annuncio server, quindi vai al passaggio successivo.

  3. La causa successiva della mancata pubblicazione degli annunci è la ricodifica degli annunci. La L'API ricodifica gli annunci durante il primo incontro per codificare l'annuncio in modo che corrisponda il video sorgente. In genere, la codifica degli annunci richiede alcuni minuti. Riprova a creare una nuova sessione dopo alcuni minuti per verificare se gli annunci sono stati inseriti.

    Se non sono stati inseriti annunci, il problema potrebbe essere dovuto alla mancata codifica di un annuncio. Gli URL multimediali degli annunci potrebbero non essere raggiungibili. In questo caso, il cliente deve collaborare con il fornitore di annunci per determinare il problema relativo ai contenuti multimediali dell'annuncio.