Instructions détaillées pour créer un projet Google Cloud et une clé d'API YouTube, éléments requis par certains types de flux tels que « Playlist » et « Search ».
Souhaitez-vous configurer la clé API YouTube dont YouTube Feed a besoin pour maintenir vos flux à jour ?
Dans ce guide, nous vous expliquerons comment créer un projet Google Cloud et activer l'API YouTube Data v3. Nous créerons ensuite la clé et l'ajouterons au plugin. Nous aborderons également le fonctionnement du quota quotidien de Google.
Avant de commencer, assurez-vous que le module « YouTube Feed » est bien installé et activé sur votre site, et que vous disposez d'un compte Google.
Voici les points que nous aborderons :
- Création d'un projet Google Cloud et d'une clé API
- Ajout de la clé API au flux YouTube
- Comment fonctionne le quota quotidien ?
- Résolution d'un problème de flux bloqué suite à un changement de compte
- Questions fréquemment posées
Remarque : les étapes relatives à Google Cloud présentées ci-dessous correspondent à l'apparence de la console Google au moment de la rédaction initiale de ce guide. Google modifie régulièrement l'affichage de ses écrans. Il se peut donc qu'un bouton se trouve à un emplacement légèrement différent. Les étapes restent toutefois les mêmes.
Création d'un projet Google Cloud et d'une clé API
Pour commencer, nous allons créer un projet dans la console développeurs de Google.
Les flux « Playlist », « Recherche », « Shorts », « Diffusions en direct » et « Vidéos individuelles » nécessitent votre propre clé API YouTube. Le flux « Chaîne » peut quant à lui utiliser un compte YouTube associé. Il est préférable d'utiliser une clé (voir la FAQ à la fin).
Note : Si vous avez déjà créé une clé API ...
Vous devrez créer un nouveau projet à l'aide de cette URL : https://console.developers.google.com/projectcreate. Vous pourrez ensuite passer à l'étape 3.
Le nouveau projet que vous venez de créer doit être celui sélectionné dans le menu déroulant en haut de la page.

1) Rendez-vous sur console.developers.google.com/apis. Si c'est la première fois que vous utilisez le site de l'API Google, il vous sera demandé d'accepter les Conditions d'utilisation.

2) Créez un projet en cliquant sur le bouton « CRÉER UN PROJET ».

3) Après avoir donné un nom à votre projet, cliquez sur le bouton « CRÉER ».

4) Ensuite, activez l'API YouTube Data v3 pour votre projet. Pour ce faire, ouvrez la page de l'API YouTube Data v3 et cliquez sur « ACTIVER ». Si vous ne suivez pas cette étape, YouTube rejettera la clé.

5) Rendez-vous sur la page « Identifiants » et cliquez sur « CRÉER DES IDENTIFIANTS ». Ce plugin nécessite une clé API. Sélectionnez ensuite cette option.

6) Copiez la clé qui s'affiche dans la fenêtre contextuelle. Vous en aurez besoin dans la section suivante.

Maintenant que vous disposez de votre clé, vous êtes prêt à l'ajouter à YouTube Feed.
Ajout de la clé API au flux YouTube
Une fois que Google vous a fourni une clé, vous devez l'ajouter dans la page « Paramètres » du plugin.
7) Dans la barre latérale d'administration de WordPress, accédez à « Flux YouTube » → « Paramètres ». Ouvrez ensuite l'onglet « Général ». Collez ensuite la clé dans le champ « Clé API ». Cliquez ensuite sur « Ajouter ».

Le plugin vérifie la clé auprès de YouTube et l'enregistre. Une coche verte s'affiche dans le champ lorsque YouTube accepte la clé. Si YouTube ne l'accepte pas, le champ affiche une icône d'erreur ainsi qu'un message contenant un lien vers ce guide.
Remarque : une nouvelle clé peut mettre jusqu'à 15 minutes pour devenir opérationnelle. Si, passé ce délai, un flux affiche toujours un message d'erreur concernant votre clé, consultez notre guide des messages d'erreur pour en connaître la signification.
Une fois une clé enregistrée, ce même bouton affiche alors « Mettre à jour ». Pour remplacer une clé, collez la nouvelle à la place de l'ancienne. Cliquez ensuite sur « Mettre à jour ».

Ajout de la clé lors de la création d'un flux
Vous pouvez également ajouter la clé lors de la création d'un flux. Lorsqu'aucune clé n'est enregistrée, l'outil de création de flux affiche une fenêtre « Clé API requise » pour tous les types de flux, à l'exception des flux « Channel » et « Social Wall ». Pour un flux « Channel », cette même fenêtre s'affiche également lorsqu'aucun compte n'est connecté.
Pour un flux de chaîne, la fenêtre propose tout d'abord une clé ou un compte YouTube associé. La clé est le meilleur choix. Un compte associé affiche également les vidéos privées, non publiées et les brouillons, et peut ne pas autoriser les « J'aime » ni les commentaires. Lorsque la fenêtre affiche ces options, cliquez sur « Ajouter une clé API » (recommandé).

Ensuite, collez votre clé dans le champ prévu à cet effet. Cliquez ensuite sur « Ajouter ». Le plugin enregistre la clé. Vous pouvez alors poursuivre la création de votre flux.

Votre clé est désormais enregistrée. Vous allez maintenant découvrir comment le quota quotidien de Google s'applique à celle-ci.
Comment fonctionne le quota quotidien ?
Google attribue à chaque projet Google Cloud un quota quotidien de requêtes. Chaque requête envoyée par YouTube Feed à YouTube à l'aide de votre clé utilise une partie de ce quota. Tous les sites et applications qui utilisent une clé de ce projet se partagent ce quota.
Lorsque le quota est épuisé, les flux utilisant cette clé cessent d'être mis à jour jusqu'à la réinitialisation du quota. Google réinitialise les quotas quotidiens à minuit, heure du Pacifique. La page de Google consacrée aux quotas indique le quota actuel et le coût de chaque type de requête.
YouTube Feed enregistre chaque flux dans son cache. La plupart des consultations de pages n'impliquent aucune requête vers YouTube. Une durée de mise en cache plus longue signifie moins de requêtes. Notre guide des messages d'erreur explique comment allonger cette durée. Il présente également à quoi ressemble le message indiquant la limite quotidienne.
Si vous avez supprimé un compte connecté et qu'un flux semble toujours bloqué, la section suivante vous explique comment le vider.
Résolution d'un problème de flux bloqué suite à un changement de compte
YouTube Feed actualise les flux en arrière-plan à l'aide des paramètres enregistrés dans la mémoire cache de chaque flux. Un flux peut être mis en cache lorsqu'un compte YouTube connecté est utilisé. Si ce compte est supprimé par la suite, ces paramètres enregistrés peuvent vider le flux ou le bloquer sur d'anciennes vidéos. Ce problème peut persister même après l'ajout d'une clé valide.
Ensuite, rendez-vous dans « Flux YouTube » » « Paramètres ». Ouvrez ensuite l'onglet « Flux ». Enfin, cliquez sur « Effacer tous les caches ». Chaque flux est alors recréé à partir de ses paramètres actuels. La prochaine mise à jour en arrière-plan s'effectuera normalement.

Et voilà ! Vous disposez désormais d'une clé API YouTube enregistrée dans YouTube Feed.
Si un flux affiche un message à la place de vos vidéos, consultez ensuite notre guide sur les messages d'erreur du flux YouTube.
Questions fréquemment posées
Vous trouverez ci-dessous les réponses à certaines des questions les plus fréquentes concernant les clés d'API YouTube.
Note : si vous souhaitez restreindre la clé API ...
Pour restreindre l'accès à votre clé API Google, utilisez la restriction « Site Web ». YouTube Feed transmet l'adresse de votre site à chaque requête, ce qui explique pourquoi cette restriction fonctionne. Dans le champ prévu à cet effet, ajoutez ces deux entrées l'une après l'autre.
- L'URL de votre site web, y compris le préfixe, par exemple
https://example.com www.googleapis.com
Vous pouvez également définir une restriction d'API. Dans ce cas, sélectionnez l'API YouTube Data v3.
Où puis-je ajouter ou remplacer ma clé API ?
Pour ajouter une clé, rendez-vous dans Flux YouTube » Paramètres » Général. Collez ensuite la clé dans le champ « Clé API », puis cliquez sur « Ajouter » ou sur « Mettre à jour » si une clé est déjà enregistrée. Le générateur de flux vous demande également une clé lorsque vous créez un flux qui en nécessite une.
Ai-je besoin d'une clé API pour chaque type de flux ?
L'outil de création de flux demande une clé pour chaque type de flux, à l'exception des flux « Channel » et « Social Wall ». Un flux « Channel » peut être alimenté à partir d'un compte YouTube connecté ou d'une clé.
Pourquoi devrais-je utiliser une clé plutôt que de me connecter avec un compte YouTube ?
La connexion d'un compte YouTube permet également d'afficher les vidéos privées, non publiées et les brouillons. Elle peut toutefois ne pas donner accès à certaines fonctionnalités, comme la consultation des « J'aime » et des commentaires. Le plugin recommande d'utiliser une clé pour éviter ces deux problèmes.
La création d'une clé API est-elle payante ?
La fenêtre « Clé API requise » du plugin indique que la création d'une clé est gratuite et ne prend que quelques minutes. C'est Google qui définit le quota et les éventuelles limites de son côté. Pour connaître les conditions en vigueur, consultez la page de Google consacrée aux quotas.