Copying a pandas Dataframe to Google Sheets with pygsheets

Disclaimer: This endeavor was before I discovered AppScript, which may be an alternative solution to using pygsheets or other python libraries. pygsheets is interesting, but it could be a stretch to justify using it for something that could be done with AppScript. Both are ways to solve a problem by automating Google Sheet operations.

This was done on the Windows 7 OS. First, install libraries with pip. Enter in command prompt or terminal:

  1. python -m pip install pandas
  2. python -m pip install numpy
  3. python -m pip install pygsheets

Then, following the steps documented by pygsheets:

  1. Create a Google Developer Account at
  2. Enable Sheets API to account
  3. Enable Drive API to account. Same as last step, but search for Drive.
  4. Create a Client Secret json file. Select “Credentials” tab, and “Create Credentials”. Select Client Secret from options. Export from console and place in same directory as your .py file.
  5. Create a Service Account json file by selecting it instead of “Client Secret”.
  6. Authorize pygsheets with your json files. (See below.)
  7. Copy spreadsheet to Google Sheet with pandas and pygsheets. (See below.)

After completing the first 5 steps, import pygsheets and authorize your account with the client secret json file:

import pygsheets
gc = pygsheets.authorize(client_secret='path/to/client_secret[...].json') 

You will be prompted by the terminal to go to a hyperlink in a browser, get your authorization code, and enter that authorization code into the terminal.

Now, import both libraries needed and switch to authorize with your service json file. Then, load the csv to a dataframe with pandas. Finally, copy it to an existing Google Sheet with pygsheets:

import pygsheets
import pandas as pd

"""Select worksheets by id, index, or title."""
gc = pygsheets.authorize(service_file='path/to/service_account_credentials.json') 
sh ='add_google_sheet_name_here')
wks = sh.worksheet_by_title('add_sheet_tab_name_here') 

"""Set a pandas dataframe to google sheet, starting at 1st row, 1st column"""
df = pd.read_csv('Example_Data.csv') 

[Example] Split and upload a sheet with 40 columns

Google Sheets limits importing to 26 columns and 1,000 rows at a time. So you’ll have to load the sheets in chunks if you have more than that. This approach uses numpy’s array_split:

import pygsheets 
import pandas as pd
import numpy as np

pandas df to Google Sheet with pygsheets - Python Marketer
gc = pygsheets.authorize(client_secret='path/to/client_secret[...].json')
sh ='add_google_sheet_name_here') 
wks = sh.worksheet_by_title('add_sheet_tab_name_here') 

"""split columns into two dataframes with numpy"""
df = pd.read_csv('Example_Data.csv') 
first_half_cols, second_half_cols = np.array_split(df.columns, 2)

"""set both dataframes side-by-side in Google sheet""" 
first_half = df[first_half_cols]

second_half = df[second_half_cols]
start_column = first_half.shape[1]
wks.set_dataframe(second_half,(1, start_column)) 


I found the terminal error messages from pygsheets to be very helpful while debugging the above. This module offers many other nifty spreadsheet operations. Solid library. You can now create and edit Google Sheets with Python.

AppsScript should probably be the default tool when working with Google Sheets because it is built in, but Python does have tools available to work with Google Sheets.


pygsheets Github

pygsheets Documentation

Google Sheets Documentation

pandas Documentation

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.