DocumentationCommerceGestion des catalogues

Ajout de vidéos de produit

Last update: Mon Jan 26 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Débutant
  • Intermédiaire
  • Administration
  • Leader
  • Utilisateur ou utilisatrice

Pour ajouter une vidéo de produit, vous devez d’abord obtenir une clé API auprès de votre compte Google et la saisir dans la configuration de votre boutique. Vous pouvez ensuite créer un lien vers la vidéo à partir du produit .

Étape 1 : obtenir votre clé API YouTube

  1. Connectez-vous à votre compte Google et rendez-vous sur la Developers Console de Google.

  2. Dans le champ de recherche en haut, saisissez YouTube Data API v3 et cliquez sur l’icône de recherche.

  3. Lorsque la page d’API s’affiche, assurez-vous qu’elle est activée.

  4. Dans le panneau de gauche, choisissez Credentials.

  5. Selon que vous disposez des informations d’identification ou non, effectuez l’une des opérations suivantes :

    • Si vous disposez déjà des informations d’identification nécessaires, copiez la clé dans la table clés API.

    • Si vous ne disposez pas déjà des informations d’identification pour cette API, cliquez sur Create Credentials dans la partie supérieure et suivez les invites pour créer les informations d’identification nécessaires. Sous Obtenir vos informations d’identification, copiez la clé API et cliquez sur Done.

  6. Copiez la clé API dans le presse-papiers.

  7. Cliquez sur l’icône Modifier à droite et définissez les restrictions pour vous assurer que la clé API est limitée aux référents corrects.

  8. Patientez quelques instants le temps que la clé soit générée, puis copiez-la dans le presse-papiers.

    À l’étape suivante, vous allez coller la clé dans la configuration de votre magasin.

Étape 2 : configurer la clé dans Commerce

  1. Dans la barre latérale Admin, accédez à Stores > Settings>Configuration.

  2. Dans le panneau de gauche, développez Catalog et choisissez Catalog en dessous.

  3. Développez Sélecteur d’extension la section Product Video​et collez votre YouTube API key.

    Configuration de la vidéo du produit {width="600" modal="regular"}

  4. Cliquez ensuite sur Save Config.

  5. Lorsque vous y êtes invité, actualisez le cache.

Étape 3 : Lien vers la vidéo

  1. Ouvrez un produit en mode d’édition.

  2. Faites défiler jusqu’à et développez la section Images and Videos.

    Images et vidéos {width="600" modal="regular"}

  3. cliquez sur Add Video.

    Si vous n’avez pas encore configuré votre clé API YouTube, cliquez sur OK pour continuer. Vous ne pouvez pas créer de lien vers une vidéo YouTube, mais vous pouvez suivre le processus.

  4. Par Url, saisissez l’URL de la vidéo YouTube ou Vimeo.

    Nouvelle vidéo pour le produit {width="600" modal="regular"}

  5. Cliquez en dehors du champ et attendez les commentaires sur la clé API ou la vidéo.

    Si tout est vérifié, YouTube fournit des informations de base sur la vidéo

  6. Saisissez le Title et la Description de la vidéo.

  7. Pour charger un Preview Image, accédez à l’image et sélectionnez le fichier.

    note note
    NOTE
    Après le chargement, l’image d’aperçu qui s’affiche est automatiquement générée par un fournisseur de services vidéo externe. Vous ne pouvez pas modifier l’image à partir de l’administration Adobe Commerce.

  8. Si vous préférez utiliser les métadonnées vidéo, cliquez sur Get Video Information.

  9. Pour déterminer comment la vidéo est utilisée dans le magasin, cochez la case de chaque Role qui s’applique :

    • Base Image
    • Small Image
    • Swatch Image
    • Thumbnail
    • Hide from Product Page

  10. Cliquez ensuite sur Save.

    note note
    NOTE
    Si l’option de configuration Autostart base video​est définie sur Yes mais que la lecture de la vidéo ne commence pas automatiquement, cela peut être dû aux politiques de lecture automatique appliquées par le navigateur et qui ne peuvent pas être contrôlées par Adobe Commerce. Chaque navigateur pris en charge possède ses propres politiques de lecture automatique qui peuvent changer au fil du temps et il se peut que votre vidéo ne soit pas lue automatiquement à l’avenir. Il est recommandé de ne pas vous fier à la lecture automatique pour les fonctionnalités critiques de l’entreprise et de tester le comportement de lecture automatique de la vidéo dans votre boutique avec chaque navigateur pris en charge.

Tenir à jour l’accès à l’API

Selon les conditions générales du développeur de Google, YouTube peut désactiver l’accès aux API pour les comptes inactifs depuis plus de 90 jours. Cette occurrence peut entraîner l’affichage de vos vidéos. Pour que l’accès à l’API reste à jour, utilisez une tâche cron pour envoyer une requête ping à l’API à intervalles réguliers :

30 10 1 * * curl -i -G -e https://yourdomain.com/ -d "part=snippet&maxResults=1&q=test&key=YOUTUBEAPIKEY" https://www.googleapis.com/youtube/v3/search >/dev/null 2>&1

Référence du champ

Champ
Description
URL
URL de la vidéo associée.
Title
Titre de la vidéo.
Description
Vidéo de description.
Preview Image
Image chargée utilisée comme aperçu de la vidéo dans votre boutique.
Get Video Information
Récupère les métadonnées vidéo stockées sur le serveur hôte. Vous pouvez utiliser les données d’origine ou les mettre à jour si nécessaire.
Role
Détermine comment l’image d’aperçu est utilisée dans votre magasin. Vous pouvez choisir n’importe quelle combinaison d’options : Base Image, Small Image, Thumbnail, Swatch Image, Hide from Product Page
recommendation-more-help
af062d56-f22c-4537-813d-bedf8b92a071