如何用Python向Google Sheets指定位置插入行分隔数据？

核心方案 #

使用gspread-dataframe库的set_with_dataframe方法，通过指定row和col参数自定义插入的起始位置，规避默认从A1插入的问题。

步骤与代码示例 #

1. 安装依赖

pip install gspread gspread-dataframe pandas google-auth

2. 认证并获取工作表对象

import gspread
from gspread_dataframe import set_with_dataframe
import pandas as pd
from google.oauth2.service_account import Credentials

# 配置认证范围
scope = ['https://spreadsheets.google.com/feeds', 'https://www.googleapis.com/auth/drive']
# 加载服务账号凭证（替换为你的credentials.json路径）
creds = Credentials.from_service_account_file('credentials.json', scopes=scope)
client = gspread.authorize(creds)

# 打开目标表格和工作表（替换为你的表格名和工作表名称）
sheet = client.open('你的表格名称').worksheet('目标工作表')

3. 分批次插入DataFrame到指定位置
   以插入到第1行的B、C、D列（对应单元格B1、C1、D1）为例：

# 插入第一个DataFrame到B1（行1，列2）
df_a = pd.DataFrame({'a': ['apple']})
set_with_dataframe(
    sheet, 
    df_a, 
    row=1, 
    col=2, 
    include_index=False, 
    include_column_header=False
)

# 插入第二个DataFrame到C1（行1，列3）
df_b = pd.DataFrame({'b': ['banana']})
set_with_dataframe(
    sheet, 
    df_b, 
    row=1, 
    col=3, 
    include_index=False, 
    include_column_header=False
)

# 插入第三个DataFrame到D1（行1，列4）
df_c = pd.DataFrame({'c': ['cantaloupe']})
set_with_dataframe(
    sheet, 
    df_c, 
    row=1, 
    col=4, 
    include_index=False, 
    include_column_header=False
)

关键参数说明 #

• row/col：起始单元格的行号/列号，均从1开始计数（例如B1对应row=1，col=2）
• include_index=False：不插入DataFrame的索引列，避免额外数据干扰
• include_column_header=False：不插入DataFrame的列名，仅插入值；若需要保留列名，设为True即可

注意事项 #

• 确保你的服务账号拥有目标Google Sheets的编辑权限
• 按顺序插入时，提前规划好每个DataFrame的起始位置，避免区域重叠覆盖

内容的提问来源于stack exchange，提问作者Alejandro