DocumentationCommerceGestion des catalogues

Ajout de vidéos de produit

Last update: Mon May 05 2025 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 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 : Obtention de la clé de l’API YouTube

  1. Connectez-vous à votre compte Google et rendez-vous sur la console de développement 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 API s’affiche, assurez-vous qu’elle est activée.

  4. Dans le panneau de gauche, choisissez Credentials.

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

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

    • Si vous ne disposez pas encore 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é d’API est limitée aux référents corrects.

  8. Patientez quelques instants pendant que la clé est 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 : configuration de la clé dans Commerce

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

  2. Dans le panneau de gauche, développez Catalog et sélectionnez Catalog sous .

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

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

  4. Une fois l’opération terminée, cliquez 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. Accédez à la section Images and Videos ​et développez-la.

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

  3. cliquez sur Add Video.

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

  4. Pour 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 extrait, YouTube fournit des informations de base sur la vidéo.

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

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

    note note
    NOTE
    Après le télé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’administrateur Adobe Commerce.

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

  9. Pour déterminer l’utilisation de la vidéo dans le magasin, cochez la case correspondant à chaque Role qui s’applique :

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

  10. Une fois l’opération terminée, cliquez 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 stratégies de lecture automatique qui sont appliquées par le navigateur et ne peuvent pas être contrôlées par Adobe Commerce. Chaque navigateur pris en charge possède ses propres stratégies de lecture automatique qui peuvent changer au fil du temps et la lecture de votre vidéo risque de ne plus être automatique à l’avenir. La bonne pratique recommandée consiste à ne pas vous fier à la lecture automatique pour les fonctionnalités critiques de l’entreprise et à tester le comportement de lecture automatique de la vidéo dans votre boutique avec chaque navigateur pris en charge.

Maintenir l’accès aux API

Selon le développeur de Google Termes et conditions, YouTube peut désactiver l’accès à l’API pour les comptes inactifs depuis plus de 90 jours. Cette occurrence peut empêcher l’affichage de vos vidéos. Pour maintenir l’accès à votre API à jour, utilisez une tâche cron pour effectuer un test ping sur 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 de champ

Champ
Description
URL
URL de la vidéo associée.
Title
Titre de la vidéo.
Description
Description de la vidéo.
Preview Image
Image chargée utilisée comme prévisualisation de la vidéo dans votre magasin.
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 la manière dont 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