見出し画像

【Python】Twitter APIを使って動画投稿を行うサンプルプログラム


Pythonを使用したTwitter APIによる動画投稿のサンプルプログラム


Twitterは動画を含むツイートを投稿するためのAPIを提供していますが、動画をアップロードしてツイートするプロセスはいくつかのステップに分かれています。この記事では、Pythonを使用してTwitter APIで動画をアップロードし、ツイートする方法について詳しく説明します。

このプログラムは、TwitterのAPI v1.1を使用してメディアをアップロードし、API v2を用いてツイートを投稿します。


### 必要なライブラリ

このスクリプトでは、以下のライブラリが使用されています:

- `os`: ファイルサイズを取得するため。

- `sys`: システム依存のパラメータや関数にアクセスするため。

- `time`: プロセスを一定時間停止させるため。

- `tweepy`: Twitter APIへの接続を容易にするため。

- `requests`: HTTPリクエストを送信するため。

- `requests_oauthlib`: OAuth認証を行うため。


認証情報の設定


oauth = OAuth1(
    CONSUMER_KEY,
    client_secret=CONSUMER_SECRET,
    resource_owner_key=ACCESS_TOKEN,
    resource_owner_secret=ACCESS_TOKEN_SECRET)

この部分で、OAuth 1.0a認証をセットアップしています。これは、Twitter APIへの安全な接続を確立するために必要です。


VideoTweetクラス

`VideoTweet`クラスは、動画ファイルを管理し、Twitterにアップロードするためのメソッドをカプセル化します。


`__init__` メソッド


def __init__(self, file_name):
    self.video_filename = file_name
    self.total_bytes = os.path.getsize(self.video_filename)
    self.media_id = None
    self.processing_info = None


ここで、動画ファイルの名前とサイズを取得し、初期化しています。


`upload_init` メソッド


def upload_init(self):

    print('INIT')

    request_data = {

        'command': 'INIT',

        'media_type': 'video/mp4',

        'total_bytes': self.total_bytes,

        'media_category': 'tweet_video'

    }

    req = requests.post(url=MEDIA_ENDPOINT_URL, data=request_data, auth=oauth)

    self.media_id = req.json()['media_id']

    print('Media ID: %s' % str(self.media_id))


このメソッドは、アップロードセッションを初期化するためにTwitter APIに`INIT`コマンドを送信します。レスポンスからメディアIDを取得して保存します。

upload_append メソッド


def upload_append(self):

    segment_id = 0

    bytes_sent = 0

    file = open(self.video_filename, 'rb')

    while bytes_sent < self.total_bytes:

        chunk = file.read(4*1024*1024)

        print('APPEND')


動画ファイルを4MBのチャンクに分割し、それぞれをTwitterにアップロードします。すべてのチャンクがアップロードされるまでこのプロセスを繰り返します。


upload_finalizeメソッド


def upload_finalize(self):

    print('FINALIZE')

    ...

    self.check_status()


全てのチャンクのアップロードが完了した後、`FINALIZE`コマンドを送信してメディアのアップロードを完了させます。その後、`check_status`メソッドを呼び出して動画の処理状況を確認します。


ツイートの投稿


def tweet(self):
    client = tweepy.Client(...)
    response = client.create_tweet(text="Here is my new photo!", media_ids=[self.media_id])

tweepyの新しいクライアントを使用して、アップロードした動画を添付してツイートを投稿します。この部分ではAPI v2が使用されています。


実行部分


if __name__ == '__main__':

    videoTweet = VideoTweet(VIDEO_FILENAME)

    videoTweet.upload_init()

    videoTweet.upload_append()

    videoTweet.upload_finalize()

    videoTweet.tweet()


このスクリプトの最後の部分で、`VideoTweet`クラスのインスタンスを作成し、定義されたメソッドを順に呼び出して動画のアップロードからツイートまでのプロセスを実行します。


まとめ

この記事では、Pythonを使用してTwitterに動画をアップロードし、ツイートする一連のプロセスを詳細に説明しました。一連のコードをすべてまとめたものは下記になります。


import os
import sys
import time
import tweepy
import json
import requests
from requests_oauthlib import OAuth1


MEDIA_ENDPOINT_URL = 'https://upload.twitter.com/1.1/media/upload.json'
POST_TWEET_URL = 'https://api.twitter.com/2/tweets'  # API v2のエンドポイントに更新


CONSUMER_KEY = 'xxxx'
CONSUMER_SECRET = 'xxxx'
ACCESS_TOKEN = 'xxxx'
ACCESS_TOKEN_SECRET = 'xxxx'



# 自分のPCのフォルダのMP4ファイルのパス
VIDEO_FILENAME = r"C:\Users\pc\Downloads\xxxxx.mp4"


oauth = OAuth1(
    CONSUMER_KEY,
  client_secret=CONSUMER_SECRET,
  resource_owner_key=ACCESS_TOKEN,
  resource_owner_secret=ACCESS_TOKEN_SECRET)


class VideoTweet(object):

  def __init__(self, file_name):
    '''
    Defines video tweet properties
    '''
    self.video_filename = file_name
    self.total_bytes = os.path.getsize(self.video_filename)
    self.media_id = None
    self.processing_info = None


  def upload_init(self):
    '''
    Initializes Upload
    '''
    print('INIT')

    request_data = {
      'command': 'INIT',
      'media_type': 'video/mp4',
      'total_bytes': self.total_bytes,
      'media_category': 'tweet_video'
    }

    req = requests.post(url=MEDIA_ENDPOINT_URL, data=request_data, auth=oauth)
    media_id = req.json()['media_id']

    self.media_id = media_id

    print('Media ID: %s' % str(media_id))


  def upload_append(self):
    '''
    Uploads media in chunks and appends to chunks uploaded
    '''
    segment_id = 0
    bytes_sent = 0
    file = open(self.video_filename, 'rb')

    while bytes_sent < self.total_bytes:
      chunk = file.read(4*1024*1024)
      
      print('APPEND')

      request_data = {
        'command': 'APPEND',
        'media_id': self.media_id,
        'segment_index': segment_id
      }

      files = {
        'media':chunk
      }

      req = requests.post(url=MEDIA_ENDPOINT_URL, data=request_data, files=files, auth=oauth)

      if req.status_code < 200 or req.status_code > 299:
        print(req.status_code)
        print(req.text)
        sys.exit(0)

      segment_id = segment_id + 1
      bytes_sent = file.tell()

      print('%s of %s bytes uploaded' % (str(bytes_sent), str(self.total_bytes)))

    print('Upload chunks complete.')


  def upload_finalize(self):
    '''
    Finalizes uploads and starts video processing
    '''
    print('FINALIZE')

    request_data = {
      'command': 'FINALIZE',
      'media_id': self.media_id
    }

    req = requests.post(url=MEDIA_ENDPOINT_URL, data=request_data, auth=oauth)
    print(req.json())

    self.processing_info = req.json().get('processing_info', None)
    self.check_status()


  def check_status(self):
    '''
    Checks video processing status
    '''
    if self.processing_info is None:
      return

    state = self.processing_info['state']

    print('Media processing status is %s ' % state)

    if state == u'succeeded':
      return

    if state == u'failed':
      sys.exit(0)

    check_after_secs = self.processing_info['check_after_secs']
    
    print('Checking after %s seconds' % str(check_after_secs))
    time.sleep(check_after_secs)

    print('STATUS')

    request_params = {
      'command': 'STATUS',
      'media_id': self.media_id
    }

    req = requests.get(url=MEDIA_ENDPOINT_URL, params=request_params, auth=oauth)
    
    self.processing_info = req.json().get('processing_info', None)
    self.check_status()


  def tweet(self):
    '''
    Publishes Tweet with attached video
    '''
    request_data = {
      'status': 'I just uploaded a video with the @TwitterAPI.',
      'media_ids': self.media_id
    }
    

    # 認証設定
    client = tweepy.Client(
        consumer_key=CONSUMER_KEY ,
        consumer_secret= CONSUMER_SECRET,
        access_token=ACCESS_TOKEN,
        access_token_secret=ACCESS_TOKEN_SECRET
    )


    # ツイートの投稿
    response = client.create_tweet(text="Here is my new photo!", media_ids=[self.media_id])

    # 結果の確認
    if response.data:
        print(f"Successfully tweeted with media! Tweet ID: {response.data['id']}")
    else:
        print("Failed to tweet with media.")
  

if __name__ == '__main__':
  videoTweet = VideoTweet(VIDEO_FILENAME)
  videoTweet.upload_init()
  videoTweet.upload_append()
  videoTweet.upload_finalize()
  videoTweet.tweet()



このサンプルプログラムを使用して、動画を含むツイートを簡単に投稿できます。動画のサイズやフォーマットに注意し、Twitterの制限内であることを確認してください。

<注意点>

プログラムを実行する前に、`YOUR_CONSUMER_KEY`、`YOUR_CONSUMER_SECRET`、`YOUR_ACCESS_TOKEN`、`YOUR_ACCESS_TOKEN_SECRET`、および`path_to_your_video.mp4`を適切な値に置き換えてください。


この記事が気に入ったらサポートをしてみませんか?