YTubeInsight

Ytubeinsight

YTubeInsight est un package Python pour YouTube Channel Analytics sans effort. Suivre les dénombrements vidéo, extraire les détails et obtenir des informations à partir des chaînes YouTube avec facilité.

Caractéristiques

• Analyser les canaux YouTube à l'aide d'URL de canal complet ou d'ID de canal
• Count des vidéos publiées au cours de la dernière année
• Récupérer des informations détaillées sur chaque vidéo (titre, date de publication, URL)
• API facile à utiliser avec une gestion complète des erreurs
• Compatibilité avec Python 3.6+

Installation

Vous pouvez installer YTubeInsight à l'aide de PIP. Nous vous recommandons d'utiliser un environnement virtuel pour gérer vos dépendances. Vous pouvez choisir entre VENV (intégré à Python) ou Conda en fonction de votre préférence.

Option 1: Utilisation de Venv

1. Créer un environnement virtuel:

    python -m venv ytubeinsight-env
   

2. Activez l'environnement virtuel:

   • Sur Windows:

      ytubeinsight-envScriptsactivate
     

   • Sur macOS et Linux:

      source ytubeinsight-env/bin/activate
     

3. Installez YTubeInsight:

    pip install ytubeinsight
   

Option 2: Utilisation de conda

1. Créer un environnement conda:

    conda create --name ytubeinsight-env python=3.8
   

2. Activez l'environnement conda:

    conda activate ytubeinsight-env
   

3. Installez YTubeInsight:

    pip install ytubeinsight
   

Démarrage rapide

Voici un exemple simple de la façon d'utiliser YTubeInsight:

 from ytubeinsight import analyze_channel

# Replace with your YouTube Data API key
API_KEY = 'YOUR_API_KEY_HERE'

# Analyze a channel by URL
channel_url = 'https://www.youtube.com/channel/UC_x5XG1OV2P6uZZ5FSM9Ttw'
result = analyze_channel ( channel_url , API_KEY )

print ( f"Videos published in the last year: { result [ 'video_count' ] } " )

# Print details of the first video
if result [ 'video_data' ]:
    video = result [ 'video_data' ][ 0 ]
    print ( f"Latest video:" )
    print ( f"Title: { video [ 'title' ] } " )
    print ( f"Published on: { video [ 'published_at' ] } " )
    print ( f"URL: { video [ 'url' ] } " )

Utilisation détaillée

Analyser un canal par URL

 from ytubeinsight import analyze_channel

result = analyze_channel ( 'https://www.youtube.com/channel/UC_x5XG1OV2P6uZZ5FSM9Ttw' , 'YOUR_API_KEY' )

Analyser un canal par id

 from ytubeinsight import analyze_channel

result = analyze_channel ( 'UCJFp8uSYCjXOMnkUyb3CQ3Q' , 'YOUR_API_KEY' , is_channel_id = True )

Gestion des erreurs

 from ytubeinsight import analyze_channel , YTubeInsightError

try :
    result = analyze_channel ( 'invalid_channel_url' , 'YOUR_API_KEY' )
except YTubeInsightError as e :
    print ( f"An error occurred: { str ( e ) } " )

Référence de l'API

analyse_channel (canal_input, api_key, is_channel_id = false)

Analyse une chaîne YouTube et renvoie les données vidéo pour la dernière année.

• channel_input : soit une URL de canal complète ou une pièce d'identité de canal
• api_key : clé API de données YouTube
• is_channel_id : Boolean indiquant si Channel_input est un ID de canal

Renvoie un dictionnaire contenant:

• video_count : Nombre de vidéos publiées l'année dernière
• video_data : liste des dictionnaires, chacun contenant les détails de la vidéo (titre, date de publication, URL)

Pour une documentation API plus détaillée, veuillez visiter notre page Read the Docs.

Obtention d'une clé API de données YouTube

Pour utiliser YTubeInsight, vous avez besoin d'une clé API de données YouTube. Voici comment en obtenir un:

1. Accédez à la console Google Developers.
2. Créez un nouveau projet ou sélectionnez un existant.
3. Activez l'API de données YouTube V3 pour votre projet.
4. Créez des informations d'identification (clé API) pour votre projet.
5. Utilisez cette clé API dans vos appels YTubeInsight.

N'oubliez pas de garder le secret de votre clé API et de ne jamais le partager publiquement.

Exigences

• Python 3.6+
• google-api-python-client
• demandes
• BeautifulSoup4

Développement

Pour configurer l'environnement de développement:

1. Clone le référentiel:

    git clone https://github.com/FahimFBA/YTubeInsight.git
   cd YTubeInsight
   

2. Créer et activer un environnement virtuel (en choisir un):

   • Utilisation de Venv:

      python -m venv venv
     source venv/bin/activate  # On Windows, use `venvScriptsactivate`
     

   • Utilisation de conda:

      conda create --name ytubeinsight-dev python=3.8
     conda activate ytubeinsight-dev
     

3. Installez les dépendances de développement:

    pip install -e .[dev]
   

4. Exécutez les tests:

    pytest
   

Contributif

Les contributions sont les bienvenues! N'hésitez pas à soumettre une demande de traction.

1. Fourchez le référentiel
2. Créez votre branche de fonctionnalité ( git checkout -b feature/AmazingFeature )
3. Commissez vos modifications ( git commit -m 'Add some AmazingFeature' )
4. Push to the Branch ( git push origin feature/AmazingFeature )
5. Ouvrir une demande de traction

Veuillez vous assurer de mettre à jour les tests le cas échéant et d'adhérer au code de conduite.

Licence

Ce projet est autorisé en vertu de la licence MIT - voir le fichier de licence pour plus de détails.

Changelog

Pour un Changelog détaillé, veuillez consulter le fichier changelog.md.

Remerciements

• Google pour avoir fourni l'API de données YouTube
• Tous les contributeurs qui aident à améliorer ce package

Soutien

Si vous rencontrez des problèmes ou si vous avez des questions, veuillez ouvrir un problème sur GitHub.

Clause de non-responsabilité

Ce projet n'est pas affilié, autorisé, entretenu, parrainé ou approuvé par YouTube ou l'un de ses sociétés affiliées ou filiales. Il s'agit d'une API indépendante et non officielle. Utiliser à vos risques et périls.