Google

[Python] スプレッドシートを作成する方法

2025-01-18更新日: 2025-01-18

Pythonでスプレッドシートを作成するには、Google Sheets APIを使用する方法があります。

Google Sheets APIを使う場合、まずGoogle Cloud ConsoleでAPIを有効化し、OAuth 2.0認証を行います。

その後、gspreadライブラリを使用してスプレッドシートを作成・操作できます。

目次から探す

Google Sheets APIを使ったスプレッドシートの作成
応用例：スプレッドシートの自動化
まとめ

Google Sheets APIを使ったスプレッドシートの作成

Google Sheets APIの概要

Google Sheets APIは、Googleのスプレッドシートをプログラムから操作するためのインターフェースです。

これを使用することで、スプレッドシートの作成、データの読み書き、フォーマットの変更などが可能になります。

Pythonを使ってAPIを操作することで、データの自動化や分析が効率的に行えます。

Google Cloud ConsoleでのAPI有効化手順

Google Cloud Consoleにアクセスし、プロジェクトを作成します。
左側のメニューから「APIとサービス」→「ライブラリ」を選択します。
Google Sheets API を検索し、有効化します。
「認証情報」を作成し、OAuth 2.0クライアントIDを取得します。

OAuth 2.0認証の設定

OAuth 2.0を使用してAPIにアクセスするためには、以下の手順を行います。

Google Cloud Consoleで「認証情報」を選択し、「OAuth同意画面」を設定します。
スコープに https://www.googleapis.com/auth/spreadsheets を追加します。
クライアントIDとクライアントシークレットを取得し、後で使用します。

gspreadライブラリのインストール

PythonでGoogle Sheets APIを操作するために、gspreadライブラリを使用します。

以下のコマンドでインストールできます。

pip install gspread oauth2client

スプレッドシートの作成手順

以下のサンプルコードを使用して、新しいスプレッドシートを作成します。

import gspread
from oauth2client.service_account import ServiceAccountCredentials
# 認証情報の設定
scope = ["https://spreadsheets.google.com/feeds", "https://www.googleapis.com/auth/drive"]
creds = ServiceAccountCredentials.from_json_keyfile_name('credentials.json', scope)
client = gspread.authorize(creds)
# 新しいスプレッドシートの作成
spreadsheet = client.create("新しいスプレッドシート")
print("スプレッドシートが作成されました:", spreadsheet.url)

スプレッドシートが作成されました: https://docs.google.com/spreadsheets/d/xxxxxxxxxxxxxxxxxxxx

スプレッドシートへのデータ書き込み

作成したスプレッドシートにデータを書き込む方法は以下の通りです。

# スプレッドシートを開く
worksheet = spreadsheet.get_worksheet(0)  # 最初のシートを取得
# データの書き込み
worksheet.update('A1', 'こんにちは')
worksheet.update('B1', 'Pythonからのデータ')

データが書き込まれました。

スプレッドシートの読み込みと更新

既存のスプレッドシートからデータを読み込む方法は以下の通りです。

# スプレッドシートを開く
spreadsheet = client.open("既存のスプレッドシート名")
worksheet = spreadsheet.get_worksheet(0)
# データの読み込み
data = worksheet.get_all_records()
print(data)

[{'A': 'こんにちは', 'B': 'Pythonからのデータ'}, ...]

エラーハンドリングとデバッグ方法

APIを使用する際には、エラーハンドリングが重要です。

以下のように例外処理を行うことで、エラーを適切に処理できます。

try:
    # スプレッドシートの操作
    worksheet.update('A1', '新しいデータ')
except gspread.exceptions.APIError as e:
    print("APIエラーが発生しました:", e)
except Exception as e:
    print("その他のエラーが発生しました:", e)

このように、エラーハンドリングを行うことで、問題が発生した際に適切な対応が可能になります。

応用例：スプレッドシートの自動化

定期的なデータ更新の自動化

定期的にデータを更新するためには、Pythonのスケジューリングライブラリを使用することができます。

scheduleライブラリを使って、特定の時間にスクリプトを実行する方法を以下に示します。

import gspread
from oauth2client.service_account import ServiceAccountCredentials
import schedule
import time
# 認証情報の設定
scope = ["https://spreadsheets.google.com/feeds", "https://www.googleapis.com/auth/drive"]
creds = ServiceAccountCredentials.from_json_keyfile_name('credentials.json', scope)
client = gspread.authorize(creds)
def update_data():
    worksheet = client.open("定期更新スプレッドシート").get_worksheet(0)
    # データの更新処理
    worksheet.update('A1', '最新データ')
    print("データが更新されました。")
# 毎日午前9時にデータを更新
schedule.every().day.at("09:00").do(update_data)
while True:
    schedule.run_pending()
    time.sleep(1)

このコードを実行すると、毎日午前9時に指定したスプレッドシートのデータが更新されます。

スプレッドシートを使ったレポート生成

スプレッドシートを利用して、データを集計しレポートを生成することも可能です。

以下のサンプルコードでは、特定のデータを集計し、レポートを作成します。

import gspread
from oauth2client.service_account import ServiceAccountCredentials
# 認証情報の設定
scope = ["https://spreadsheets.google.com/feeds", "https://www.googleapis.com/auth/drive"]
creds = ServiceAccountCredentials.from_json_keyfile_name('credentials.json', scope)
client = gspread.authorize(creds)
# データを集計する関数
def generate_report():
    worksheet = client.open("データ集計スプレッドシート").get_worksheet(0)
    data = worksheet.get_all_records()
    
    # 集計処理(例：合計を計算)
    total = sum(item['金額'] for item in data)
    
    # レポートを新しいシートに書き込む
    report_worksheet = client.create("レポート").get_worksheet(0)
    report_worksheet.update('A1', '合計金額')
    report_worksheet.update('B1', total)
generate_report()

このコードを実行すると、指定したスプレッドシートからデータを集計し、新しいスプレッドシートにレポートを作成します。

Google Sheets APIを使ったリアルタイムデータの共有

リアルタイムでデータを共有するためには、Google Sheets APIを使用して、他のユーザーとスプレッドシートを共有することができます。

以下のサンプルコードでは、特定のメールアドレスにスプレッドシートを共有します。

import gspread
from oauth2client.service_account import ServiceAccountCredentials
# 認証情報の設定
scope = ["https://spreadsheets.google.com/feeds", "https://www.googleapis.com/auth/drive"]
creds = ServiceAccountCredentials.from_json_keyfile_name('credentials.json', scope)
client = gspread.authorize(creds)
# スプレッドシートを共有する関数
def share_spreadsheet(email):
    spreadsheet = client.open("共有するスプレッドシート")
    spreadsheet.share(email, perm_type='user', role='writer')
    print(f"{email} にスプレッドシートが共有されました。")
share_spreadsheet("example@example.com")