前言
這篇文章是 【Python】設定 google sheet API 並取得 json 金鑰，讓我們的資料能同步更新至雲端 google sheet 表格 (內含完整圖片說明) 的下一篇，
【Python 網頁爬蟲 #1】設定 google sheet API 並取得 json 金鑰，讓我們的資料能同步更新至雲端 google sheet 表格 (內含完整圖片說明)
這篇我們專注再設定程式碼的部分。
如果還有「設定 google sheet API 並取得 json 金鑰」的問題，請去上面的文章進行操作。
pygsheets 操作
pygsheets 已經幫我們把大部分的複雜功能簡化過了，因此我們可以很容易的使用 pygsheets 來操作 google sheets，
重要的前置步驟，共用 google sheet 編輯者 (讓程式可以編輯)
跟我們通常使用 google sheet 邀請共同編輯的概念相同，我們一樣可以在 google sheet 中找到共享的部分，
並且把要編輯的文件共享給上篇文章設定的開發者 email
這邊只要按下確認就會自動開啟權限了，不用特別再去收信什麼的。
不知道 email 在哪的，這張圖幫你回憶一下：
pygsheets 讀入 sheet
這邊我們要注意兩個地方，
- 一個是我們剛剛下載下來的 json 金鑰，記得貼上對應的路徑位置
- 一個是你的 google sheet 網址 (看網址就知道了)，記得貼上
import pygsheets
auth_file = "xxxxxxxxxxxxxxxxxxxxxxxxxx.json"
gc = pygsheets.authorize(service_file = auth_file)
# setting sheet
sheet_url = "https://docs.google.com/spreadsheets/d/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx/"
sheet = gc.open_by_url(sheet_url)
這樣做完後，sheet 就已經被我們讀進來了。
pygsheets 從 sheet 找對應 工作表
工作表就是我們 google sheet 下方會看到的工作表分頁，這邊我們要找一樣的名字。
#選取by名稱
sheet_test01 = sheet.worksheet_by_title("test01")
pygsheets 表格讀取 (read)
# read
A1 = sheet_test01.cell('A1')
print(A1)
print(A1.value)
- 範例
- 結果
pygsheets 表格寫入 (write)
# write
sheet_test01.update_value('A2', "test_A2") # 單一個
sheet_test01.update_values('B2', [['A', 'B', 'C', 'D']]) # 橫的
sheet_test01.update_values('A3', [['3'],['4'],['5'],['6']]) # 直的
- 結果
pygsheets 表格插入 (insert)
插入某一行，要注意邏輯是我們填入的數字的後一行
(換句話說，我們如果填 1，「 1 不會動，會插入的是 2 」)
# insert
col = 1
sheet_test01.insert_cols(col, number=3) # add 2, 3, 4 (B, C, D)
row = 1
sheet_test01.insert_rows(row, number=3) # add 2, 3, 4
- 結果
pygsheets 帶有值的表格插入 (insert with values)
內建的函數就有這個 keyword arguments，直接使用即可，
(注意 values 必須是 matrix。)
# insert with values
values = [['M', 'N', 'O']] # matrix
insert_rows = 1 # add start from 2
sheet_test01.insert_rows(insert_rows, number=1, values=values)
- 結果
pygsheets 表格結尾填入 (append)
會直接插在文件的最末尾，注意 values 必須是 matrix
# append
values = [['X', 'Y', 'Z']] # matrix
sheet_test01.append_table(values=values)
- 結果
最後，把自己常用的功能封裝，供以後方便使用
留給我以後重複開發類似功能，實作快速使用，順便幫助有需要的人
import pygsheets
auth_file = "xxxxxxxx.json"
gc = pygsheets.authorize(service_file = auth_file)
sheet_url = "https://docs.google.com/spreadsheets/d/xxxxxxxxxxxxxxxxxxx/"
global_sheet = gc.open_by_url(sheet_url)
class google_sheet_helper:
def __init__(self, sheet_name = "work01"):
# setting sheet
self.working_sheet = global_sheet.worksheet_by_title(sheet_name)
def write(self, position = "A1", content = "test"):
self.working_sheet.update_value(position, content)
def read(self, position = "A1"):
content = self.working_sheet.cell(position)
print(content)
print(content.value)
def append(self, values = []):
self.working_sheet.append_table(values=values)
def insert(self, insert_rows = 1, values = []): # insert_rows = 1, start from 2
self.working_sheet.insert_rows(insert_rows, number=1, values=values)
[…] 【Python】透過 pygsheets 操作 google sheet API，讓我們的資料能同步更新至雲端 go… […]