YTubeInsight

Ytubeinsight

Ytubeinsight - это пакет Python для легкой аналитики канала YouTube. Отслеживайте количество видео, извлеките детали и с легкостью получают информацию из каналов YouTube.

Функции

• Проанализируйте каналы YouTube, используя либо полноканальные URL -адреса, либо идентификаторы канала
• Граф видео, опубликованные в течение прошлого года
• Получить подробную информацию о каждом видео (название, публикация даты, URL)
• Простой в использовании API с комплексной обработкой ошибок
• Совместимость с Python 3.6+

Установка

Вы можете установить ytubeinsight с помощью PIP. Мы рекомендуем использовать виртуальную среду для управления вашими зависимостями. Вы можете выбрать между Venv (встроенным в Python) или Conda на основе ваших предпочтений.

Вариант 1: Использование Venv

1. Создайте виртуальную среду:

    python -m venv ytubeinsight-env
   

2. Активировать виртуальную среду:

   • В окнах:

      ytubeinsight-envScriptsactivate
     

   • На macOS и Linux:

      source ytubeinsight-env/bin/activate
     

3. Установите ytubeinsight:

    pip install ytubeinsight
   

Вариант 2: Использование Conda

1. Создайте среду Conda:

    conda create --name ytubeinsight-env python=3.8
   

2. Активировать среду Conda:

    conda activate ytubeinsight-env
   

3. Установите ytubeinsight:

    pip install ytubeinsight
   

Быстрый старт

Вот простой пример того, как использовать 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' ] } " )

Подробное использование

Анализ канала по URL

 from ytubeinsight import analyze_channel

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

Анализ канала по ID

 from ytubeinsight import analyze_channel

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

Обработка ошибок

 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 ) } " )

Ссылка на API

Analyze_channel (Channel_input, api_key, is_channel_id = false)

Анализирует канал YouTube и возвращает видеоданные за последний год.

• channel_input : либо полный URL -адрес канала, либо идентификатор канала
• api_key : Ключ данных YouTube Data
• is_channel_id : логический показатель, указывающий, что канал - это идентификатор канала

Возвращает словарь, содержащий:

• video_count : количество видео, опубликованных в прошлом году
• video_data : список словарей, каждый из которых содержит видео (заголовок, дата публикации, URL)

Для более подробной документации API, пожалуйста, посетите нашу страницу «Читать документы».

Получение ключа API данных на YouTube

Чтобы использовать ytubeinsight, вам нужен ключ API данных на YouTube. Вот как его получить:

1. Перейдите в консоли разработчиков Google.
2. Создайте новый проект или выберите существующий.
3. Включите API V3 YouTube API V3 для вашего проекта.
4. Создайте учетные данные (ключ API) для вашего проекта.
5. Используйте этот ключ API в ваших вызовах ytubeinsight.

Не забудьте сохранить свой ключ API и никогда не делиться им публично.

Требования

• Python 3.6+
• Google-Api-Python-Client
• запросы
• BeautifulSoup4

Разработка

Чтобы настроить среду разработки:

1. Клонировать репозиторий:

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

2. Создайте и активируйте виртуальную среду (выберите одну):

   • Используя Вен:

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

   • Используя Conda:

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

3. Установите зависимости разработки:

    pip install -e .[dev]
   

4. Запустите тесты:

    pytest
   

Внося

Взносы приветствуются! Пожалуйста, не стесняйтесь отправить запрос на привлечение.

1. Вилка репозитория
2. Создайте филиал своей функции ( git checkout -b feature/AmazingFeature )
3. Сделайте свои изменения ( git commit -m 'Add some AmazingFeature' )
4. Толкайте к ветке ( git push origin feature/AmazingFeature )
5. Откройте запрос на тягу

Пожалуйста, обязательно обновите тесты по мере необходимости и придерживайтесь кодекса поведения.

Лицензия

Этот проект лицензирован по лицензии MIT - для получения подробной информации см. Файл лицензии.

Изменение

Для получения подробного ChangeLog, см. Файл Changelog.md.

Благодарности

• Google для предоставления API данных на YouTube
• Все участники, которые помогают улучшить этот пакет

Поддерживать

Если вы столкнетесь с какими -либо проблемами или у вас есть какие -либо вопросы, пожалуйста, откройте проблему на GitHub.

Отказ от ответственности

Этот проект не связан, уполномочен, поддерживается, спонсируется или одобряется YouTube или какими -либо его филиалами или дочерними компаниями. Это независимый и неофициальный API. Используйте свой собственный риск.