Google スプレッドシート用のオープンソース Python API

オープン ソースの Python ライブラリを介して、Excel XML スプレッドシート ファイルを作成、共有、解析、変更します。

Gspread は、Google スプレッドシートのオープン ソース Python 実装です。このライブラリにより、コンピューター プログラマーは、独自の Python アプリケーションからスプレッドシート ファイルを作成、開き、変更することができます。日を追うごとに、Google スプレッドシートなどのオンライン サービスを使用する人がますます増えています。

新しいスプレッドシートの作成、スプレッドシートの選択と共有、ワークシートの作成、ワークシートの削除、セル値の取得、シート行だけでなく列からの値の取得、検索など、いくつかの重要な機能が Gspread ライブラリによって完全にサポートされています。セル、セル値の更新、セルからリストとしての値の取得など。

Previous Next

Gspread の概要

Gspread をスムーズに実行するには、システムに Python 3.6 以降がインストールされている必要があります。 PIP 経由でインストールするための推奨される方法。次のコマンドを使用してください。

PIP コマンドで Gspread をインストールする

 pip install gspread 

Python ライブラリを使用してスプレッドシートを作成および共有する

Gspread API は、新しいスプレッドシートの作成と変更のための機能を提供します。ソフトウェア プログラマーは、わずか数コマンドで、独自の Python アプリケーション内に空白のスプレッドシートを作成できます。新しいスプレッドシートは、スクリプトのアカウントにのみ表示されることに注意してください。アクセスできるようにするには、新しく作成したスプレッドシートをメールで共有する必要があります。その中にワークシートを簡単に作成できます。

スプレッドシートを生成し、ワークシートを Python ライブラリ経由で作成します。

 sh = gc.create('A new spreadsheet')
# Add a new worksheet to the list of current sheets
try:
        sheet = spreadsheet.worksheet(tab_label)
    except gspread.exceptions.WorksheetNotFound:
        spreadsheet.add_worksheet( tab_label, 1, len(col_defs) )
        sheet = spreadsheet.worksheet( tab_label )

Python でスプレッドシートを開く

オープン ソースのスプレッドシート ライブラリ Gspread を使用すると、ソフトウェア開発者はわずか数行のコードで CSV ファイルを Excel 2003 XML ファイル形式に変換できます。まず、解析対象の CSV ファイルをサーバーから読み込み、パーサーからライターにデータを転送し、ライター タイプを XML に変更する必要があります。その後、指定された名前と指定されたターゲットでファイルを保存します。

既存のスプレッドシートを開く Pythonライブラリ

# You can open a spreadsheet by its title as it appears in Google Docs
sh = gc.open('My poor gym results') # <-- Look ma, no keys!
# If you want to be specific, use a key (which can be extracted from the spreadsheet's url)
sht1 = gc.open_by_key('0BmgG6nO_6dprdS1MN3d3MkdPa142WFRrdnRRUWl1UFE')
# Or, if you feel really lazy to extract that key, paste the entire url
sht2 = gc.open_by_url('https://docs.google.com/spreadsheet/ccc?key=0Bm...FE&hl')

Excel 2003 XML ファイルの解析

Gspread ライブラリを使用すると、開発者は、Google ドキュメントに表示されるタイトルを提供することで、利用可能なスプレッドシートを開くことができます。正確には、スプレッドシートの URL から取得できるキーを提供する必要があります。キーを抽出するのが難しい場合は、完全な URL を提供することもできます。特定のワークシートまたは使用可能なすべてのワークシートのリストを選択することもできます。

スプレッドシートのセルと行の操作

1 つまたは複数のワークシート セルから他のセルにデータをコピーすることは、非常に一般的な方法です。 Gspread API は、セル データの操作を完全にサポートします。セルまたはスプレッドシートの行と列から値を簡単に取得できます。この API は、ワークシートからすべての値をリストのリストとして取得する機能も提供します。正確な値でセルを検索したり、正規表現で同等のセルを検索したりすることもできます。

Pythonライブラリを介してスプレッドシートセルに基本的なフォーマットを適用

# Set text format to bold:
worksheet.format('A1:B1', {'textFormat': {'bold': True}})
# Color the background of a Cell range in black
# change horizontal alignment, text color and font size
worksheet.format("A2:B2", {
    "backgroundColor": {
      "red": 0.0,
      "green": 0.0,
      "blue": 0.0
    },
    "horizontalAlignment": "CENTER",
    "textFormat": {
      "foregroundColor": {
        "red": 1.0,
        "green": 1.0,
        "blue": 1.0
      },
      "fontSize": 12,
      "bold": True
    }
})
 日本