如何使用 Drive API 在 Google 电子表格中获取工作表列表（名称和“gid”）？

Question

I am trying to use Google Drive API (Python) to download some tabs of a spreadsheet file. Is the gids information in the file's metadata? What I am trying to do is (this may not be correct, please suggest):

file_metadata = self.service.files().get(file_id=file_id).execute()
# in the following line, how can I get a download url with a gid (a tab in a spreadsheet file)
download_url = file_metadata.get('exportLinks')['text/csv']
# download the file.

Answer 1

Indeed this seems to be a duplicate of How to convert Google spreadsheet's worksheet string id to integer index (GID)?

Here is the quick answer:

def to_gid(worksheet_id):
    return int(worksheet_id, 36) ^ 31578

Answer 2

You can do this using the Spreadsheet service in Google Apps Script. It's not as convenient as having a direct API call, but at least it is possible:

1. Call the SpreadsheetApp.openById(id) method to open the spreadsheet using the Drive file_id .
2. Call the Spreadsheet.getSheets() method to retrieve a list of Sheet objects.
3. For each sheet, call the Sheet.getSheetId() and Sheet.getSheetName() methods to get the name (which is what the spreadsheet user sees) and the sheetId (which is what needs to be provided in the gid= parameter when exporting).

You can use the recently-announced Apps Script Execution API to provide a REST API for your Apps Script project, which you can then call in a similar manner to the Drive API.

Answer 3

You can use an old visualization API URL

f'https://docs.google.com/spreadsheets/d/{doc_id}/gviz/tq?tqx=out:csv&sheet={sheet_name}'

to download a sheet by its name. I just posted this here together with code for the Google API Python library. This is also mentioned in another answer which links to the Charts docs where it is shown how to do this with a gid . Alternatively, you can download all sheets by exporting the spreadsheet as an eg Excel file,

class MimeTypes:
    EXCEL = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"

drive_api.files().export_media(fileId=file_id, mimeType=MimeTypes.EXCEL)

If you still want to go with getting sheets by gid , the gid is the sheetId in the Google Sheets API (see here ).

And you should be able to use the Sheets API to get all the sheets - and their corresponding sheetId s.

Answer 4

I have a radical idea: given that you intend to automate things a bit and already know (at least some) python, why not export data from the tabs you need to CSV files, download them, and then import as pandas.DataFrame s. After all, these data structures have been modeled after Google (and Excel) Sheets and are equally intuitive to use.