Risoluzione dei problemi

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

Viene restituito solo il primo errore. Se per una richiesta si verificano più errori, devi correggere l'errore restituito e riprovare 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 file manifest video dall'elemento 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 l'elemento sourceUri fornito sia collegato a un file manifest video valido.

    • Usa curl con sourceUri. Se il file manifest deve essere accessibile pubblicamente, assicurati che l'URL possa essere raggiunto pubblicamente.
    • Se il sourceUri è corretto e il file 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, ti consigliamo di 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 questi passaggi per diagnosticare il problema:

  1. Se la chiave CDN è stata registrata di recente con l'API Video Stitcher, attendi almeno 5 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 sono state registrate più chiavi CDN 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 in una sessione dal vivo non sono stati inseriti annunci, per diagnosticare il problema procedi nel seguente modo:

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

    • Se il file manifest del video di origine non ha indicatori di annunci, significa che il encoder 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, vai 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 esempio, Chrome) e verifica che venga restituita 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. Verificare che il tag annuncio sia impostato correttamente con gli ad server.

    • Se la risposta VAST è compilata, utilizza curl per richiedere il tag annuncio. Alcuni ad server richiedono di fornire l'intestazione User-Agent. 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 durante 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 ancora restituita una risposta vuota, il problema riguarda il tag annuncio specificato. Verifica con il cliente che il tag annuncio sia corretto e che tutti i valori delle macro dei tag annuncio siano corretti.

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

  3. Esamina la sessione dal vivo. Se la sessione interessata indica che gli annunci vengono restituiti dagli ad server, procedi con il passaggio successivo.

  4. La prossima potenziale causa della mancanza di annunci è la ricodifica degli annunci. L'API ricodifica gli annunci durante il primo incontro per codificare l'annuncio in modo che corrisponda 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 nessun annuncio è stato inserito, il problema può 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 cosa c'è che non va nei suoi media pubblicitari.

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 esempio, 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. Verificare che il tag annuncio sia impostato correttamente con gli ad server.

    • Se la risposta VAST è compilata, utilizza curl per richiedere il tag annuncio. Alcuni ad server richiedono di fornire l'intestazione User-Agent. 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 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 usa l'intestazione durante l'esecuzione del tag annuncio per recuperare gli annunci.

    • Se viene ancora restituita una risposta vuota, il problema riguarda il tag annuncio specificato. Verifica con il cliente che il tag annuncio sia corretto e che tutti i valori delle macro dei tag annuncio siano 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 indica che gli annunci vengono restituiti dagli ad server, procedi con il passaggio successivo.

  3. La prossima potenziale causa della mancanza di annunci è la ricodifica degli annunci. L'API ricodifica gli annunci durante il primo incontro per codificare l'annuncio in modo che corrisponda 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 nessun annuncio è stato inserito, il problema può 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 cosa c'è che non va nei suoi media pubblicitari.