Risolvere i problemi

Questa pagina mostra come risolvere i problemi relativi all'API Video Stitcher. Gli errori riportati 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 dall'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.

    • Utilizza 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 dover 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 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 seleziona una delle chiavi CDN con cui firmare l'URL.

Nessun annuncio inserito in una sessione live

Se non sono stati inseriti annunci in una sessione live, segui i passaggi riportati di seguito per diagnosticare il problema:

  1. Verifica che i live streaming di origine abbiano inserito 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 di origine non contiene indicatori di annuncio, significa che il codificatore non ha attivato un'interruzione pubblicitaria o che deve essere modificato per inserire gli indicatori di annuncio supportati.

    • Se gli indicatori degli annunci sono chiaramente visibili nel file manifest di origine, 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 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 che venga fornito 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 compilata, il problema è che l'User-Agent header deve essere passato all'API Video Stitcher durante la creazione della sessione live. 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 anche i valori di qualsiasi macro 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, 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 dei contenuti multimediali dell'annuncio 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 seguendo le istruzioni riportate di seguito:

    • 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 che venga fornito 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 anche i valori di qualsiasi macro 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, vai al passaggio successivo.

  3. La causa successiva della mancata pubblicazione degli annunci è la ricodifica degli annunci. L'API ricoderà gli annunci durante il primo rilevamento 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 dei contenuti multimediali dell'annuncio 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.