Pour activer l'API Video Stitcher pour votre projet, veuillez contacter votre responsable de compte ou le service commercial pour en savoir plus.

Cette page a été traduite par l'API Cloud Translation.

Dépannage

Cette page vous explique comment résoudre les problèmes liés à l'API Video Stitcher. Erreurs présenté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 vous devez corriger l'erreur renvoyée et relancer la requête pour voir 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 :

Vérifiez que l'sourceUri fourni redirige vers un fichier manifeste vidéo valide.
- Utilisez curl avec sourceUri. Si le fichier manifeste doit être accessible au public, assurez-vous que l'URL est accessible publiquement.
- Si le sourceUri est correct et que le fichier manifeste vidéo nécessite la signature d'URL, passez à l'étape suivante.
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.
- Vérifiez que la configuration de clé CDN correspondant au nom d'hôte sourceUri existe. Si la configuration ne existe, enregistrer la clé CDN avec l'API Video Stitcher. Patientez au moins cinq minutes pour que la configuration se termine. à se propager au service.
- Si la configuration existe, passez à l'étape suivante.
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 :

Si la clé CDN a été récemment enregistrée auprès de l'API Video Stitcher, attendez au moins cinq minutes pour permettre la propagation de la mise à jour. Si le problème persiste, passez à l'étape suivante.
Vérifiez qu'une seule clé CDN est enregistrée pour un nom d'hôte de 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.
- Assurez-vous qu'une seule clé CDN a été enregistrée auprès d'un nom d'hôte pour une région donnée. Supprimez la clé CDN obsolète.

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 :

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, continuez à l'étape suivante.
Vérifiez que le tag d'emplacement publicitaire 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'emplacement publicitaire. Vérifiez que la balise publicitaire est correctement configurée avec les serveurs publicitaires.
- 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 le paramètre 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 lorsque pour créer 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 de tags d'emplacement publicitaire du client ont été résolus, mais que les annonces n'ont pas été diffusées inséré, passez à l'étape suivante.
Inspectez la session en direct. Si la session concernée montre que les annonces sont renvoyées par l'annonce les serveurs, puis passez à l'étape suivante.
La deuxième cause possible d'absence d'annonces est le re-encodage des annonces. La L'API réencode les annonces lors de sa première interaction afin d'encoder l'annonce de sorte qu'elle corresponde la vidéo source. L'encodage des annonces prend généralement quelques minutes. Réessayer de créer une nouvelle session après quelques minutes pour voir si des annonces ont été 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 publicitaires 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.

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

Vérifiez que le tag d'emplacement publicitaire fourni renvoie une réponse VAST ou VMAP non vide. Utilisez le tag d'annonce fourni en suivant les instructions suivantes :
- Copiez le tag d'emplacement publicitaire dans la barre d'adresse d'un navigateur Web (par exemple, Chrome). vérifie qu'il renvoie une réponse VAST, VMAP ou SmartXML non vide. Voici une réponse VAST vide :
- Placez le tag d'emplacement publicitaire dans un navigateur Web (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 la balise publicitaire est correctement configurée avec les serveurs publicitaires.
- 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 le paramètre 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 d'une session de vidéo à la demande. 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 provient de la réponse du tag d'emplacement publicitaire. Vérifiez auprès du client que le tag d'emplacement publicitaire est correct tout Macro de tag d'emplacement publicitaire sont également correctes.
- Si les problèmes de tags d'emplacement publicitaire du client ont été résolus, mais que les annonces n'ont pas été diffusées inséré, passez à l'étape suivante.
Inspectez la session de vidéo à la demande. Si la session concernée montre que les annonces sont renvoyées par l'annonce les serveurs, puis passez à l'étape suivante.
La prochaine cause potentielle de non-diffusion d'annonces est la suivante : le réencodage des annonces. L'API réencode les annonces lors de leur première rencontre pour les encoder de manière à ce qu'elles correspondent à 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 publicitaires ne soient pas accessibles. Dans ce cas, le client doit Collaborez avec le fournisseur d'annonces pour identifier le problème.