Synchronisation de données entre YouTube et WordPress à chaque sauvegarde
Comment relier chaque article WordPress à une vidéo YouTube et mettre à jour automatiquement titre, description, mots-clés et miniature côté YouTube et WordPress, via une extension dédiée et l'API YouTube Data v3, sur un site multilingue.
Contexte : un site éditorial relié à une chaîne YouTube
Chaque article a sa vidéo, mais l'équipe ressaisissait tout dans YouTube Studio.
Le site WordPress publie des contenus vidéo en parallèle d'une chaîne YouTube officielle. Chaque article correspond à une vidéo : l'équipe travaille dans WordPress, mais la visibilité sur YouTube dépend d'un titre, d'une description et de tags à jour sur la plateforme.
Sans automatisation, la double saisie est chronophage et source d'écarts : description différente de YouTube, miniature non rafraîchie, oublis de mots-clés. Le site étant multilingue, la description YouTube devait en outre refléter toutes les versions linguistiques du contenu.
L'objectif : une sauvegarde WordPress = une mise à jour YouTube, sans passer par YouTube Studio.
Ce que l'équipe voulait
✓Éditer uniquement dans WordPress
✓Une description YouTube toujours à jour
✓Toutes les langues dans une seule description
✓La même miniature sur le site et sur YouTube
Périmètre
Périmètre : que synchronise l'extension ?
Chaque post WordPress porte un identifiant YouTube (`videoId`). À la sauvegarde, en création comme en mise à jour, l'extension déclenche un flux de synchronisation vers l'API YouTube Data v3. Le périmètre couvre les métadonnées visibles sur YouTube et le retour visuel côté WordPress, pour que l'équipe n'ait qu'un seul endroit où éditer le fond.
Titre de la vidéo YouTube aligné sur le titre du post source
Description YouTube construite dynamiquement à partir du contenu
Mots-clés / tags YouTube dérivés des champs éditoriaux WordPress
Miniature YouTube récupérée et posée en image à la une du post
Liaison persistante post ↔ `videoId` dans les métadonnées WordPress
Prise en charge des brouillons et des mises à jour successives
Une sauvegarde, une mise à jour
Plugin WordPress
Plugin WordPress : ce qui se passe à la sauvegarde
Un plugin PHP sur mesure : champ pour le `videoId`, hook sur `save_post`, couche de service pour l'API YouTube et gestion des erreurs réseau.
01
Enregistrer
L'éditeur sauvegarde son article : le hook `save_post` s'exécute, avec des garde-fous anti-boucle et autosave.
02
Mapper
Les champs ACF ou meta deviennent titre, description et tags YouTube, toutes traductions incluses.
03
Envoyer
Le client YouTube Data API v3 met à jour la vidéo via OAuth 2.0 (jeton du compte de la chaîne).
04
Rapatrier
La miniature officielle est téléchargée et attachée au post comme image à la une.
05
Journaliser
Les erreurs API sont tracées pour le débogage, sans jamais bloquer la sauvegarde.
Multilingue
Multilingue : description YouTube agrégée
Les contenus existent en plusieurs langues, liées par le système multilingue du site. La description YouTube ne peut pas se limiter à la langue en cours d'édition : elle doit donner une vue consolidée aux spectateurs internationaux. À chaque sauvegarde, l'extension agrège le contenu de toutes les traductions liées au post, avec un titre de section par langue. L'éditeur met à jour une langue, la description YouTube suit sans action manuelle.
Détection des traductions liées au post courant
Construction d'une description multi-blocs par langue
Ordre et séparateurs configurables pour la lisibilité
Mise à jour même si seule une traduction est modifiée
Gestion des cas limites : traduction manquante ou en brouillon
Toutes les langues
API
YouTube Data API v3 : endpoints et contraintes
La synchronisation s'appuie sur l'API YouTube Data v3 : lecture des métadonnées existantes, mise à jour via `videos.update` pour le snippet et récupération des URL de miniatures. Les quotas API et les limites de longueur (description, nombre de tags) ont été pris en compte dès la conception : les appels partent uniquement à la sauvegarde, pas en polling continu. En cas d'échec (quota, vidéo supprimée, ID invalide), l'extension affiche une notice admin sans bloquer la sauvegarde WordPress.
Authentification OAuth 2.0 avec jeton de rafraîchissement du compte de la chaîne
Méthode `videos.update` pour titre, description et tags
Récupération des thumbnails (default, medium, high)
Gestion des erreurs 403, 404 et quota exceeded
Respect des limites de caractères et nettoyage du contenu
Miniatures
Miniatures : de YouTube vers WordPress
Après la mise à jour des métadonnées, l'extension télécharge la miniature YouTube, en priorité la version haute résolution, et l'injecte dans la médiathèque WordPress. L'image devient la miniature du post : l'équipe retrouve sur le site la même vignette que sur YouTube, sans import manuel.
Téléchargement distant via `media_sideload_image` ou équivalent
Nom de fichier dérivé du `videoId` pour éviter les doublons
Mise à jour de la miniature si YouTube change la vignette
Compatibilité avec les thèmes utilisant `the_post_thumbnail`
Bilan
Bilan du projet
L'équipe gagne un flux unique : elle édite dans WordPress, et YouTube suit. Les descriptions multilingues sont cohérentes, les miniatures alignées, et la chaîne reflète le site sans double saisie.
Extension WordPress dédiée, maintenable et documentée
Synchronisation titre, description et tags à chaque sauvegarde
