使用 Python 从 Google Drive / Workspace 下载电子表格

Question

您能否制作一个 Python 示例，说明如何在给定密钥和工作表 ID (gid) 的情况下下载 Google Sheets 电子表格？我不能。

我已经搜索了 API 的版本 1、2 和 3。我运气不好，我无法弄清楚他们复杂的类似 ATOM 的提要 API，gdata.docs.service.DocsService._DownloadFile 私有方法说我未经授权，而且我不知道我不想自己编写整个 Google 登录身份验证系统。由于沮丧，我快要捅自己的脸了。

我有一些电子表格，我想像这样访问它们：

username = '[email protected]'
password = getpass.getpass()

def get_spreadsheet(key, gid=0):
    ... (help!) ...

for row in get_spreadsheet('5a3c7f7dcee4b4f'):
    cell1, cell2, cell3 = row
    ...

请保重我的面子。

---

更新 1： 我已尝试以下操作，但 Download() 或 Export() 的组合似乎不起作用。 （DocsService 的文档 这里)

import gdata.docs.service
import getpass
import os
import tempfile
import csv

def get_csv(file_path):
  return csv.reader(file(file_path).readlines())

def get_spreadsheet(key, gid=0):
  gd_client = gdata.docs.service.DocsService()
  gd_client.email = '[email protected]'
  gd_client.password = getpass.getpass()
  gd_client.ssl = False
  gd_client.source = "My Fancy Spreadsheet Downloader"
  gd_client.ProgrammaticLogin()

  file_path = tempfile.mktemp(suffix='.csv')
  uri = 'http://docs.google.com/feeds/documents/private/full/%s' % key
  try:
    entry = gd_client.GetDocumentListEntry(uri)

    # XXXX - The following dies with RequestError "Unauthorized"
    gd_client.Download(entry, file_path)

    return get_csv(file_path)
  finally:
    try:
      os.remove(file_path)
    except OSError:
      pass

Answer 1

我正在使用这个：
卷曲'https:// docs.google.com/spreadsheets/d/1-lqLuYJyHAKix-T8NR8wV8ZUUbVOJrZTysccid2-ycs/gviz/tq?tqx=out:csv' 在设置为公开可读的工作表上。

因此，如果您可以使用公共工作表，您将需要 python 版本的curl。

如果您的工作表包含一些您不想显示的选项卡，请创建一个新工作表，并将要发布的范围导入到其上的选项卡中。

Answer 2

使用表格从谷歌文档下载电子表格非常简单。

上的详细文档进行操作

您可以按照https://pypi.org/project/gsheets/

或按照下面给出的步骤。 我建议阅读文档以获得更好的覆盖范围。

1. pip install gsheets

2. 使用您要访问其电子表格的 Google 帐户登录 Google 开发者控制台。创建（或选择）一个项目并启用 Drive API 和 Sheets API（在 Google Apps API 下）。

3. 转到您的项目的凭据并创建新凭据> OAuth 客户端 ID >其他类型。在 OAuth 2.0 客户端 ID 列表中，单击刚刚创建的客户端 ID 的“下载 JSON”。将文件保存为您的主目录（用户目录）中的 client_secrets.json。

4. 使用以下代码片段。

    from gsheets import Sheets
    sheets = Sheets.from_files('client_secret.json')
    print(sheets) # will ensure authenticate connection
    
    s = sheets.get("{SPREADSHEET_URL}")
    print(s) # will ensure your file is accessible 
    
    s.sheets[1].to_csv('Spam.csv', encoding='utf-8', dialect='excel') # will download the file as csv

Answer 3

这不是一个完整的答案，但 Andreas Kahler 使用 Google Docs + Google App Engline + 编写了一个有趣的 CMS 解决方案Python。由于没有该领域的任何经验，我无法确切地看出代码的哪一部分可能对您有用，但请检查一下。我知道它与 Google Docs 帐户交互并处理文件，所以我有一种感觉，您会意识到发生了什么。它至少应该为您指明正确的方向。

Google AppEngine + Google 文档 + 一些 Python = 简单 CMS< /a>

Answer 4

Gspread 确实比 GoogleCL 和 Gdata（这两个我都使用过，谢天谢地已经被 Gspread 淘汰）有了很大的改进。我认为这段代码比之前的答案更快地获取工作表的内容：

username = '[email protected]'
password = 'sdfsdfsadfsdw'
sheetname = "Sheety Sheet"

client = gspread.login(username, password)
spreadsheet = client.open(sheetname)

worksheet = spreadsheet.sheet1
contents = []
for rows in worksheet.get_all_values():
    contents.append(rows)

Answer 5

（2019 年 3 月，Python 3）我的数据通常不敏感，我通常使用类似于 CSV 的表格格式。

在这种情况下，人们可以简单地将工作表发布到网络，然后将其用作服务器上的 CSV 文件。

（使用 File -> Publish to the web ... -> Sheet 1 -> 逗号分隔来发布它值 (.csv) -> 发布)。

import csv
import io
import requests

url = "https://docs.google.com/spreadsheets/d/e/<GOOGLE_ID>/pub?gid=0&single=true&output=csv"  # you can get the whole link in the 'Publish to the web' dialog
r = requests.get(url)
r.encoding = 'utf-8'
csvio = io.StringIO(r.text, newline="")
data = []
for row in csv.DictReader(csvio):
    data.append(row)

Answer 6

https://github.com/burnash/gspread 库是一种更新、更简单的与 Google 互动的方式电子表格，而不是建议使用 gdata 库的旧答案，它不仅级别太低，而且过于复杂。

您还需要创建并下载（JSON 格式）服务帐户密钥：https:// /console.developers.google.com/apis/credentials/serviceaccountkey

以下是如何使用它的示例：

import csv
import gspread
from oauth2client.service_account import ServiceAccountCredentials

scope = ['https://spreadsheets.google.com/feeds']
credentials = ServiceAccountCredentials.from_json_keyfile_name('credentials.json', scope)

docid = "0zjVQXjJixf-SdGpLKnJtcmQhNjVUTk1hNTRpc0x5b9c"

client = gspread.authorize(credentials)
spreadsheet = client.open_by_key(docid)
for i, worksheet in enumerate(spreadsheet.worksheets()):
    filename = docid + '-worksheet' + str(i) + '.csv'
    with open(filename, 'wb') as f:
        writer = csv.writer(f)
        writer.writerows(worksheet.get_all_values())

Answer 7

如果有人遇到此问题并寻求快速解决方案，这里有另一个（当前）有效的解决方案，它不依赖于 gdata 客户端图书馆：

#!/usr/bin/python

import re, urllib, urllib2

class Spreadsheet(object):
    def __init__(self, key):
        super(Spreadsheet, self).__init__()
        self.key = key

class Client(object):
    def __init__(self, email, password):
        super(Client, self).__init__()
        self.email = email
        self.password = password

    def _get_auth_token(self, email, password, source, service):
        url = "https://www.google.com/accounts/ClientLogin"
        params = {
            "Email": email, "Passwd": password,
            "service": service,
            "accountType": "HOSTED_OR_GOOGLE",
            "source": source
        }
        req = urllib2.Request(url, urllib.urlencode(params))
        return re.findall(r"Auth=(.*)", urllib2.urlopen(req).read())[0]

    def get_auth_token(self):
        source = type(self).__name__
        return self._get_auth_token(self.email, self.password, source, service="wise")

    def download(self, spreadsheet, gid=0, format="csv"):
        url_format = "https://spreadsheets.google.com/feeds/download/spreadsheets/Export?key=%s&exportFormat=%s&gid=%i"
        headers = {
            "Authorization": "GoogleLogin auth=" + self.get_auth_token(),
            "GData-Version": "3.0"
        }
        req = urllib2.Request(url_format % (spreadsheet.key, format, gid), headers=headers)
        return urllib2.urlopen(req)

if __name__ == "__main__":
    import getpass
    import csv

    email = "" # (your email here)
    password = getpass.getpass()
    spreadsheet_id = "" # (spreadsheet id here)

    # Create client and spreadsheet objects
    gs = Client(email, password)
    ss = Spreadsheet(spreadsheet_id)

    # Request a file-like object containing the spreadsheet's contents
    csv_file = gs.download(ss)

    # Parse as CSV and print the rows
    for row in csv.reader(csv_file):
        print ", ".join(row)

Answer 8

您可以尝试使用导出电子表格 文档部分。

为电子表格服务获取单独的登录令牌，并将其替换为导出。将其添加到 get_spreadsheet 代码中对我有用：

import gdata.spreadsheet.service

def get_spreadsheet(key, gid=0):
    # ...
    spreadsheets_client = gdata.spreadsheet.service.SpreadsheetsService()
    spreadsheets_client.email = gd_client.email
    spreadsheets_client.password = gd_client.password
    spreadsheets_client.source = "My Fancy Spreadsheet Downloader"
    spreadsheets_client.ProgrammaticLogin()

    # ...
    entry = gd_client.GetDocumentListEntry(uri)
    docs_auth_token = gd_client.GetClientLoginToken()
    gd_client.SetClientLoginToken(spreadsheets_client.GetClientLoginToken())
    gd_client.Export(entry, file_path)
    gd_client.SetClientLoginToken(docs_auth_token) # reset the DocList auth token

请注意，我还使用了 Export，因为 Download 似乎只提供 PDF 文件。

Answer 9

（2016 年 7 月） 所有其他答案都已经过时或将会过时，因为它们使用 GData（“Google 数据”）协议，ClientLogin，或 AuthSub，全部已被弃用。对于使用 Google Sheets API v3 或更早版本的所有代码或库也是如此。

现代 Google API 访问使用 API 密钥（用于访问公共数据）、OAuth2 客户端 ID（用于访问用户拥有的数据）或服务帐户（用于访问应用程序/云中拥有的数据）进行，主要使用 适用于 GCP API 和 适用于非 GCP API 的 Google API 客户端库。对于此任务，Python 的后者。

为了实现这一点，您的代码需要获得 Google Drive API 的授权访问权限，也许是为了查询特定的表格下载，然后执行实际导出。由于这可能是常见操作，因此我编写了 博客文章分享了一个可以为您完成此操作的代码片段。如果您想进一步了解这一点，我还有另一对 帖子以及一个视频，概述了如何将文件上传到 Google 云端硬盘以及如何从 Google 云端硬盘下载文件。

请注意，还有一个 Google Sheets API v4，但它主要用于面向电子表格的操作，即插入数据、读取电子表格行、单元格格式、创建图表、添加数据透视表等，而不是基于文件的请求，例如导出，其中 Drive API 是正确的使用。

我写了一篇博文来演示从云端硬盘将 Google 表格导出为 CSV。脚本的核心部分：

# setup
FILENAME = 'inventory'
SRC_MIMETYPE = 'application/vnd.google-apps.spreadsheet'
DST_MIMETYPE = 'text/csv'
DRIVE = discovery.build('drive', 'v3', http=creds.authorize(Http()))

# query for file to export
files = DRIVE.files().list(
    q='name="%s" and mimeType="%s"' % (FILENAME, SRC_MIMETYPE), orderBy='modifiedTime desc,name').execute().get('files', [])

# export 1st match (if found)
if files:
    fn = '%s.csv' % os.path.splitext(files[0]['name'].replace(' ', '_'))[0]
    print('Exporting "%s" as "%s"... ' % (files[0]['name'], fn), end='')
    data = DRIVE.files().export(fileId=files[0]['id'], mimeType=DST_MIMETYPE).execute()
    if data:
        with open(fn, 'wb') as f:
            f.write(data)
        print('DONE')

要了解有关将 Google Sheets 与 Python 结合使用的更多信息，请参阅我对类似问题的回答。您还可以下载 XLSX 和其他云端硬盘支持的格式的工作表。

如果您对 Google API 完全陌生，那么您需要先退一步并查看这些视频：

• 如何使用 Google API 和创建 API 项目 - 用户界面已更改，但概念仍然相同
• 授权样板代码演练 (Python) - 您可以使用任何支持的语言 访问 Google API；如果您不会使用 Python，请将其用作伪代码来帮助您入门
• 列出您的文件在 Google 云端硬盘中并深入研究代码post

如果您已经拥有 Google Workspace（以前称为 G Suite、Google Apps、Google“Docs”）API 的使用经验，并且希望观看有关使用这两个 API 的更多视频：

• Sheets API 视频库
• 云端硬盘 API 视频库
• Google Workspace (G Suite) 开发展示视频我制作的系列

Answer 10

从 gdata 2.0.1.4 开始，这不再有效：

gd_client.SetClientLoginToken(spreadsheets_client.GetClientLoginToken())

相反，您必须执行以下操作：

gd_client.SetClientLoginToken(gdata.gauth.ClientLoginToken(spreadsheets_client.GetClientLoginToken()))

Answer 11

我编写了 pygsheets 作为 gspread 的替代品，但使用了 google api v4。它有一个export方法来导出电子表格。

import pygsheets

gc = pygsheets.authorize()

# Open spreadsheet and then workseet
sh = gc.open('my new ssheet')
wks = sh.sheet1

#export as csv
wks.export(pygsheets.ExportType.CSV)

Answer 12

以下代码适用于我的情况（Ubuntu 10.4，python 2.6.5 gdata 2.0.14）

import gdata.docs.service
import gdata.spreadsheet.service
gd_client = gdata.docs.service.DocsService()
gd_client.ClientLogin(email,password)
spreadsheets_client = gdata.spreadsheet.service.SpreadsheetsService()
spreadsheets_client.ClientLogin(email,password)
#...
file_path = file_path.strip()+".xls"
docs_token = gd_client.auth_token
gd_client.SetClientLoginToken(spreadsheets_client.GetClientLoginToken())
gd_client.Export(entry, file_path)  
gd_client.auth_token = docs_token

Answer 13

我通过删除不必要的面向对象进一步简化了@Cameron 的答案。这使得代码更小并且更容易理解。我还编辑了网址，这可能会更好。

#!/usr/bin/python
import re, urllib, urllib2

def get_auth_token(email, password):
    url = "https://www.google.com/accounts/ClientLogin"
    params = {
        "Email": email, "Passwd": password,
        "service": 'wise',
        "accountType": "HOSTED_OR_GOOGLE",
        "source": 'Client'
    }
    req = urllib2.Request(url, urllib.urlencode(params))
    return re.findall(r"Auth=(.*)", urllib2.urlopen(req).read())[0]

def download(spreadsheet, worksheet, email, password, format="csv"):
    url_format = 'https://docs.google.com/spreadsheets/d/%s/export?exportFormat=%s#gid=%s'

    headers = {
        "Authorization": "GoogleLogin auth=" + get_auth_token(email, password),
        "GData-Version": "3.0"
    }
    req = urllib2.Request(url_format % (spreadsheet, format, worksheet), headers=headers)
    return urllib2.urlopen(req)


if __name__ == "__main__":
    import getpass
    import csv

    spreadsheet_id = ""             # (spreadsheet id here)
    worksheet_id = ''               # (gid here)
    email = ""                      # (your email here)
    password = getpass.getpass()

    # Request a file-like object containing the spreadsheet's contents
    csv_file = download(spreadsheet_id, worksheet_id, email, password)

    # Parse as CSV and print the rows
    for row in csv.reader(csv_file):
        print ", ".join(row)