Intégration de l'API YouTube – Connectez les analyses de votre chaîne
Connectez-vous une fois via Google OAuth et obtenez des analyses synchronisées quotidiennement (CPM, RPM, fidélisation de l'audience et vitesse de visualisation) sans jamais exporter un CSV ni visiter YouTube Studio séparément.
What is Intégration de l'API YouTube and when should you use it?
Connectez-vous une fois via Google OAuth et obtenez des analyses synchronisées quotidiennement (CPM, RPM, fidélisation de l'audience et vitesse de visualisation) sans jamais exp...
What is Intégration de l'API YouTube?
L'intégration de l'API YouTube est la principale connexion de données de TubeAnalytics qui relie la chaîne YouTube d'un créateur à la plateforme via l'authentification Google OAuth 2.0. Une fois autorisé, TubeAnalytics lit les données de l'API YouTube Analytics et de l'API YouTube Data v3 (les mêmes points de terminaison authentifiés qui alimentent YouTube Studio) pour importer des mesures de performances vidéo, des données démographiques d'audience, des données de monétisation et des métadonnées de chaîne. L'accès aux analyses et aux métadonnées est en lecture seule. La seule exception est la gestion des commentaires : la portée `youtube.force-ssl` permet au tableau de bord des commentaires de répondre aux commentaires, de les modérer, de les signaler comme spam et de les supprimer sur les vidéos du créateur. TubeAnalytics ne peut pas mettre en ligne ni publier de vidéos, modifier les métadonnées des vidéos, modifier les paramètres de la chaîne, supprimer des vidéos ni accéder à des données non publiques au-delà de ce que le créateur autorise explicitement sur l'écran de consentement OAuth. Les portées d'analyse limitent TubeAnalytics exactement aux données qu'un créateur peut déjà voir dans YouTube Studio. Les synchronisations de données s'effectuent quotidiennement. L'intégration de l'API YouTube est disponible sur tous les forfaits et constitue la base de toutes les autres fonctionnalités et intégrations de TubeAnalytics.
Connection Details
Connection Type
OAuth
Sync Cadence
Synchronisation automatique quotidienne. Les données historiques sont importées lors de la connexion initiale aussi loin que l'API le permet — généralement 90 jours avec Starter, 1 an avec Professional et jusqu'à 5 ans avec Enterprise.
Authentication Method
Google OAuth 2.0 avec quatre champs d'accès YouTube : youtube.readonly, yt-analytics.readonly et yt-analytics-monetary.readonly (lecture seule), ainsi que youtube.force-ssl pour la gestion des commentaires et la lecture des pistes de sous-titres des vidéos du créateur. L'autorisation peut être révoquée à tout moment depuis la page des autorisations du compte Google du créateur.
Evidence and Validation
This integration summary is reviewed against product documentation and publicly available reference sources to keep integration guidance stable.
- Integration capability documentation is published across TubeAnalytics product pages.
- Connection models and data flow descriptions are documented in integration setup references.
- Compatible tool documentation is linked for validation of integration workflows.
What Intégration de l'API YouTube includes
Authentification OAuth en un clic
Connectez votre chaîne YouTube en moins de deux minutes grâce au flux de consentement OAuth de Google. Aucune clé API à générer, aucun jeton à copier, aucune configuration de développeur requise. La connexion fonctionne avec n'importe quelle chaîne YouTube disposant d'un compte Google.
Synchronisation quotidienne automatisée des données
Une fois connecté, TubeAnalytics extrait automatiquement de nouvelles données analytiques toutes les 24 heures.
Importation complète des données historiques
Lors de la connexion initiale, TubeAnalytics importe les données d'analyse historiques de votre chaîne aussi loin que l'API YouTube le permet. Le plan Starter importe 90 jours, le plan Professional importe 1 an et le plan Enterprise importe jusqu'à 5 ans de données historiques.
Accès sécurisé en lecture seule
Les portées d'analyse et de métadonnées sont en lecture seule. La gestion des commentaires est la seule capacité d'écriture : youtube.force-ssl vous permet de répondre aux commentaires et de les modérer sur vos propres vidéos depuis le tableau de bord. Google protège ses points de terminaison de sous-titres avec cette même portée ; c'est donc aussi elle qui permet à l'outil de transcription de lire les pistes de sous-titres de vos propres vidéos — en lecture seule, rien n'est réécrit. TubeAnalytics ne peut pas mettre en ligne ni publier de vidéos, modifier les métadonnées des vidéos, modifier les paramètres de la chaîne ni supprimer des vidéos. Révoquez l'accès à tout moment depuis les paramètres de votre compte Google.
Exportation de données multiformats
Toutes les données extraites via l'API YouTube sont exportables au format CSV, PDF ou via l'API TubeAnalytics. Utilisez les données exportées à des fins de reporting personnalisé, d'analyse de feuilles de calcul ou d'archivage parallèlement à votre tableau de bord en direct.
Récupération automatique des erreurs
Si l'API YouTube subit une panne, TubeAnalytics réessaye automatiquement la synchronisation manquée. Un jeton OAuth expiré ou révoqué ne peut pas être réessayé : la synchronisation de cette chaîne s'arrête jusqu'à ce que vous réautorisiez la connexion.
How to set up Intégration de l'API YouTube
- 1
Initier la connexion depuis TubeAnalytics
Accédez à Paramètres > Chaînes dans votre tableau de bord TubeAnalytics et cliquez sur « Ajouter une chaîne ». Vous êtes redirigé vers l'écran de consentement OAuth de Google où vous choisissez le compte Google associé à votre chaîne YouTube.
- 2
Examinez et approuvez les autorisations OAuth
Google affiche les autorisations demandées par TubeAnalytics. Les portées d'analyse, de revenus et de métadonnées sont en lecture seule ; youtube.force-ssl permet la gestion des commentaires et l'accès aux pistes de sous-titres des chaînes connectées. Vérifiez l'écran de consentement avant de sélectionner « Autoriser ».
- 3
TubeAnalytics importe les données de votre chaîne
Après autorisation, TubeAnalytics commence à importer l'historique d'analyse de votre chaîne. La synchronisation initiale traite votre vidéothèque, vos données d'audience et vos statistiques de revenus en fonction de la limite de données historiques de votre forfait. La plupart des chaînes sont entièrement synchronisées dans les 24 heures suivant la connexion.
- 4
Les synchronisations quotidiennes maintiennent vos données à jour
TubeAnalytics effectue une synchronisation quotidienne qui met à jour toutes les mesures (nombre de vues, durée de visionnage, nombre d'abonnés, CPM, RPM et données d'engagement) afin que votre tableau de bord reflète toujours les dernières données YouTube Analytics disponibles sans aucune action manuelle.
- 5
Gérez et surveillez votre connexion
Depuis Paramètres > Chaînes, vous pouvez lancer une synchronisation manuelle. Déconnectez-vous à tout moment pour arrêter la collecte de données.
- Accès OAuth délimité
- Portées OAuth : lecture seule pour les analyses et les métadonnées ; youtube.force-ssl couvre la gestion des commentaires et la lecture des sous-titres pour les transcriptions, dans les deux cas limitées à vos propres vidéos
Google OAuth Scope Documentation, 2024
Example scenarios
Illustrative examples, not customer results.
Créateur basé sur les données, 45 000 abonnés
Challenge: Je souhaitais créer des tableaux de bord personnalisés et des alertes automatisées à l'aide des données YouTube, mais il me manquait l'expertise technique nécessaire pour travailler directement avec l'API YouTube Analytics.
Approach: L'intégration de l'API YouTube a géré automatiquement toute l'authentification de l'API et la récupération des données. Le créateur a accédé à son ensemble complet de données d'analyse via le tableau de bord et les exportations de TubeAnalytics sans écrire un seul appel d'API. Lorsqu'ils ont ensuite eu besoin d'intégrations personnalisées, l'API TubeAnalytics a fourni les mêmes données sans nécessiter de gestion directe de l'API YouTube.
Frequently asked questions
- Qu'est-ce que l'intégration de l'API YouTube TubeAnalytics ?
- L'intégration de l'API YouTube est la couche de connexion qui relie votre chaîne YouTube à TubeAnalytics via Google OAuth 2.0. Une fois autorisé, TubeAnalytics extrait les données de l'API YouTube Analytics et de l'API YouTube Data v3 (les mêmes points de terminaison authentifiés que YouTube Studio utilise) pour remplir votre tableau de bord avec les performances vidéo, l'audience, les revenus et les métadonnées. L'accès aux analyses et aux métadonnées est en lecture seule ; la gestion des commentaires utilise en plus la portée youtube.force-ssl afin que vous puissiez répondre aux commentaires et les modérer sur vos propres vidéos. L'intégration se synchronise automatiquement à une cadence quotidienne. Il s'agit de la connexion de base requise pour toutes les fonctionnalités de TubeAnalytics et est disponible sur chaque plan.
- L'intégration de l'API YouTube est-elle sécurisée ?
- Oui, et voici exactement ce qui est accordé. TubeAnalytics demande quatre portées YouTube via Google OAuth 2.0 : youtube.readonly pour les métadonnées des vidéos et de la chaîne, yt-analytics.readonly pour les données de performances, yt-analytics-monetary.readonly pour les données de revenus, et youtube.force-ssl pour le gestionnaire de commentaires et l'outil de transcription. Les trois premières sont en lecture seule. youtube.force-ssl est une portée en lecture/écriture, utilisée pour deux choses : répondre aux commentaires, les modérer, les signaler comme spam et les supprimer sur vos propres vidéos depuis le tableau de bord des commentaires, et lire les pistes de sous-titres sur lesquelles repose l'outil de transcription — Google protège ses points de terminaison de sous-titres avec youtube.force-ssl, donc youtube.readonly ne suffit pas pour les récupérer. Les transcriptions n'utilisent que des lectures. Les commentaires sont le seul endroit où le produit écrit sur YouTube — TubeAnalytics ne peut pas mettre en ligne ni publier de vidéos, modifier les titres, descriptions, tags ou miniatures, modifier les paramètres de la chaîne ni supprimer des vidéos. Vous pouvez vérifier et révoquer l'accès à tout moment depuis la page « Applications tierces ayant accès à votre compte » de votre compte Google. TubeAnalytics chiffre également tous les jetons OAuth au repos et les renouvelle selon le calendrier d'expiration des jetons de Google.
- Combien de temps prend la synchronisation initiale des données ?
- La synchronisation initiale s'effectue généralement dans les 24 heures pour la plupart des chaînes. Pendant cette période, TubeAnalytics importe les métadonnées de votre vidéothèque, l'historique d'analyse, les données démographiques de l'audience et les données de revenus aussi loin que votre forfait le permet (90 jours Starter, 1 an Professional, 5 ans Enterprise). La synchronisation s'exécute en arrière-plan : vous pouvez fermer le navigateur et y revenir plus tard pour trouver vos données prêtes. Après l'importation initiale, les synchronisations incrémentielles quotidiennes ne prennent que quelques minutes pour traiter les nouvelles données, car elles n'extraient que les mises à jour depuis la dernière synchronisation réussie.
- Que se passe-t-il si mon jeton OAuth expire ?
- Les jetons Google OAuth expirent après une période définie (généralement 6 à 12 mois selon le type de jeton) ou si vous modifiez le mot de passe de votre compte Google. Lorsqu'un jeton expire, TubeAnalytics détecte l'échec de la synchronisation et arrête de synchroniser cette chaîne jusqu'à ce que vous réautorisiez la connexion.
- Puis-je connecter plusieurs chaînes YouTube à un seul compte TubeAnalytics ?
- Oui. TubeAnalytics prend en charge les connexions à plusieurs canaux sous un seul compte. Le plan Starter prend en charge 1 canal, Professional prend en charge jusqu'à 3 canaux et Enterprise prend en charge jusqu'à 5 canaux. Chaque canal est soumis à son propre flux d'autorisation OAuth et est géré indépendamment depuis Paramètres > Chaînes. Des vues multicanaux sont disponibles sur les forfaits Professionnel et Entreprise, vous permettant de voir des mesures globales sur tous les canaux connectés dans une seule vue de tableau de bord.
- Quelles données l'intégration de l'API YouTube extrait-elle ?
- L'intégration extrait des analyses au niveau vidéo (vues, durée de visionnage, CTR, durée moyenne de visionnage), des données d'audience (données démographiques, courbes de rétention, nouveaux spectateurs et spectateurs connus), des mesures de revenus (CPM, RPM, performances du type d'annonce, revenus estimés), des répartitions des sources de trafic (Parcourir, Recherche, Suggérées, Externes, Notifications) et des métadonnées vidéo (titres, descriptions, balises, dates de publication, vignettes). L'ensemble de données exact disponible dépend de la conservation des données de l'API YouTube Analytics et du niveau de votre forfait TubeAnalytics. Toutes les données correspondent à ce que vous voyez dans YouTube Studio, car les deux plates-formes utilisent les mêmes points de terminaison d'API.
Try Intégration de l'API YouTube free for 30 days
Payment info required. Available on all plans.