Dépannage

Cette page vous explique comment résoudre les problèmes liés à l'API Video Stitcher. Les erreurs affichées sur cette page sont spécifiques à l'API Video Stitcher. Pour en savoir plus sur les erreurs génériques dans les API Google, consultez la page Erreurs des API Cloud.

Seule la première erreur est renvoyée. Si une requête rencontre plusieurs erreurs, vous devez corriger l'erreur renvoyée et réessayer la requête pour afficher l'erreur suivante.

Impossible de récupérer la playlist lors de la création d'une session

Le problème suivant se produit lorsque l'API Video Stitcher ne parvient pas à extraire le fichier manifeste vidéo à partir de l'sourceUri spécifiée.

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

Pour résoudre ce problème, procédez comme suit:

  1. Vérifiez que l'sourceUri fourni redirige vers un fichier manifeste vidéo valide.

    • Utilisez curl avec sourceUri. Si le fichier manifeste est destiné à être accessible au public, assurez-vous que l'URL est accessible au public.
    • Si le sourceUri est correct et que le fichier manifeste vidéo nécessite la signature d'URL, passez à l'étape suivante.

  2. Assurez-vous que la clé CDN a été enregistrée auprès de l'API Video Stitcher dans la même région que la requête.

  3. Si vous pensez que la clé privée utilisée pour signer l'URL est incorrecte, vous pouvez mettre à jour la clé CDN enregistrée avec la clé privée appropriée.

La clé CDN est obsolète

Si vous avez récemment enregistré ou mis à jour une clé CDN et que l'API Video Stitcher n'a pas commencé à signer les URL à l'aide de la nouvelle configuration, suivez les étapes ci-dessous pour diagnostiquer le problème:

  1. Si la clé CDN a été enregistrée récemment auprès de l'API Video Stitcher, patientez au moins cinq minutes pour permettre la propagation de la mise à jour. Si le problème persiste, passez à l'étape suivante.

  2. Vérifiez qu'une seule clé CDN est enregistrée pour un seul nom d'hôte pour la région. Si plusieurs clés CDN ont été enregistrées avec le même nom d'hôte, l'API Video Stitcher sélectionne l'une des clés CDN pour signer l'URL.

Aucune annonce n'est insérée dans une session en direct.

Si aucune annonce n'a été insérée dans une session en direct, procédez comme suit pour diagnostiquer le problème:

  1. Vérifiez que les diffusions en direct sources ont inséré des coupures publicitaires dans le fichier manifeste. Les repères publicitaires suivants doivent exister dans le fichier manifeste de la vidéo en direct pour indiquer à l'API Video Stitcher de remplacer les segments vidéo sources par des segments publicitaires.

    • Si le fichier manifeste de la vidéo source ne contient pas de repères d'annonce, votre encodeur n'a pas déclenché de coupure publicitaire ou doit être modifié pour insérer les repères d'annonce compatibles.

    • Si les repères d'annonce sont clairement visibles dans le fichier manifeste source, passez à l'étape suivante.

  2. Vérifiez que le tag d'annonce fourni renvoie une réponse VAST non vide.

    • Copiez la balise publicitaire dans la barre d'adresse d'un navigateur Web (Chrome, par exemple) et vérifiez qu'elle renvoie une réponse VAST non vide. Voici une réponse VAST vide:

      <VAST version="3.0"/>

    • Si une réponse VAST vide est renvoyée, le problème vient du tag d'annonce. Vérifiez que le tag d'annonce est correctement configuré avec les serveurs d'annonces.

    • Si la réponse VAST est renseignée, utilisez curl pour demander le tag d'annonce. Certains serveurs publicitaires exigent que l'en-tête User-Agent soit fourni. Essayez la commande curl suivante:

      curl AD_TAG_URI

    • Si la commande curl renvoie une réponse VAST vide, ajoutez l'en-tête User-Agent à la commande 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

    • Si une réponse VAST renseignée est renvoyée, le problème est que l'en-tête User-Agent doit être transmis à l'API Video Stitcher lors de la création de la session en direct. L'API Video Stitcher utilise cet en-tête lors de l'exécution du tag d'emplacement publicitaire pour récupérer les annonces.

    • Si une réponse vide est toujours renvoyée, le problème concerne la balise publicitaire donnée. Vérifiez auprès du client que le tag d'annonce est correct et que les valeurs de la macro de tag d'annonce sont également correctes.

    • Si les problèmes liés aux balises publicitaires du client ont été résolus, mais que les annonces n'ont pas été insérées, passez à l'étape suivante.

  3. Inspectez la session en direct. Si la session concernée indique que des annonces sont renvoyées à partir des serveurs d'annonces, passez à l'étape suivante.

  4. La deuxième cause possible d'annonces manquantes est le re-encodage des annonces. L'API réencode les annonces lors de leur première rencontre pour les encoder de manière à les adapter à la vidéo source. L'encodage des annonces prend généralement quelques minutes. Réessayez de créer une session après quelques minutes pour voir si des annonces sont insérées.

    Si aucune annonce n'a été insérée, le problème peut être dû à l'échec de l'encodage d'une annonce. Les URL des supports d'annonces peuvent être inaccessibles. Dans ce cas, le client doit collaborer avec le fournisseur d'annonces pour déterminer le problème lié à son contenu publicitaire.

Aucune annonce n'est insérée dans une session VOD.

  1. Vérifiez que le tag d'annonce fourni renvoie une réponse VAST ou VMAP non vide. Utilisez le tag d'annonce fourni en suivant les instructions suivantes:

    • Copiez la balise d'annonce dans la barre d'adresse d'un navigateur Web (Chrome, par exemple) et vérifiez qu'elle renvoie une réponse VAST, VMAP ou SmartXML non vide. Voici une réponse VAST vide:

    • Insérer la balise publicitaire dans un navigateur Web (par exemple, (Chrome, Firefox, etc.) et vérifie qu'il renvoie une réponse VAST, VMAP ou SmartXML non vide. Voici un exemple de réponse VAST vide:

      <VAST version="3.0"/>

      Voici une réponse VMAP vide:

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

    • Si une réponse VAST vide est renvoyée, le problème vient du tag d'annonce. Vérifiez que le tag d'annonce est correctement configuré avec les serveurs d'annonces.

    • Si la réponse VAST est renseignée, utilisez curl pour demander le tag d'annonce. Certains serveurs publicitaires exigent que l'en-tête User-Agent soit fourni. Essayez la commande curl suivante:

      curl AD_TAG_URI

    • Si la commande curl renvoie une réponse VAST vide, ajoutez l'en-tête User-Agent à la commande 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

    • Si une réponse VAST ou VMAP renseignée est renvoyée, le problème est que l'en-tête User-Agent doit être transmis à l'API Video Stitcher lors de la création de la session VOD. L'API Video Stitcher utilise cet en-tête lors de l'exécution du tag d'annonce pour récupérer les annonces.

    • Si une réponse vide est toujours renvoyée, le problème concerne la balise publicitaire donnée. Vérifiez auprès du client que le tag d'annonce est correct et que les valeurs de la macro de tag d'annonce sont également correctes.

    • Si les problèmes liés aux balises publicitaires du client ont été résolus, mais que les annonces n'ont pas été insérées, passez à l'étape suivante.

  2. Inspectez la session de vidéo à la demande. Si la session concernée indique que des annonces sont renvoyées à partir des serveurs d'annonces, passez à l'étape suivante.

  3. La deuxième cause possible d'absence d'annonces est le re-encodage des annonces. L'API réencode les annonces lors de leur première rencontre pour les encoder de manière à les adapter à la vidéo source. L'encodage des annonces prend généralement quelques minutes. Réessayez de créer une session après quelques minutes pour voir si des annonces sont insérées.

    Si aucune annonce n'a été insérée, le problème peut être dû à l'échec de l'encodage d'une annonce. Il est possible que les URL des supports multimédias de l'annonce ne soient pas accessibles. Dans ce cas, le client doit collaborer avec le fournisseur d'annonces pour déterminer le problème lié à son contenu publicitaire.