{"name":"gspread: A Python API for Seamless Google Sheets Integration","description":"gspread is a powerful Python API designed for seamless interaction with Google Sheets. It offers a simple and comprehensive interface to programmatically open, read, write, and format data in spreadsheets, along with managing worksheets and access permissions. This library is an essential tool for automating Google Sheets operations directly from Python applications.","github":"https://github.com/burnash/gspread","url":"https://osrepos.com/repo/burnash-gspread","source":"osrepos.com","sourceDescription":"This repository profile is provided by osrepos.com, an open source repository discovery platform.","repositoryProfile":"https://osrepos.com/repo/burnash-gspread","generatedFor":"open source discovery and AI-assisted research","markdown":"https://osrepos.com/repo/burnash-gspread.md","json":"https://osrepos.com/repo/burnash-gspread.json","topics":["gspread","Python","google-sheets","google-sheets-api","spreadsheet","Data Management","API Client","Automation"],"keywords":["gspread","Python","google-sheets","google-sheets-api","spreadsheet","Data Management","API Client","Automation"],"stars":null,"summary":"gspread is a powerful Python API designed for seamless interaction with Google Sheets. It offers a simple and comprehensive interface to programmatically open, read, write, and format data in spreadsheets, along with managing worksheets and access permissions. This library is an essential tool for automating Google Sheets operations directly from Python applications.","content":"## Introduction\n\ngspread is a robust Python library that provides a simple yet powerful interface for working with Google Sheets. It allows developers to programmatically access, modify, and manage Google Spreadsheets, making it ideal for automation, data processing, and reporting tasks. With gspread, you can easily open spreadsheets by title, key, or URL, read and write cell ranges, control sharing and access, and perform batch updates. Please note that the project is currently looking for new maintainers to continue its development and support.\n\n## Installation\n\nTo install gspread, use pip:\n\nsh\npip install gspread\n\n\ngspread requires Python 3.8+ to run.\n\n## Examples\n\n### Basic Usage\n\nAfter creating credentials in the Google API Console, you can start using gspread:\n\npython\nimport gspread\n\n# Authenticate using a service account (or oauth, api_key)\ngc = gspread.service_account()\n\n# Open a spreadsheet by title\nwks = gc.open(\"Where is the money Lebowski?\").sheet1\n\n# Update a range of cells\nwks.update([[1, 2], [3, 4]], \"A1\")\n\n# Update a single cell\nwks.update_acell(\"B42\", \"it's down there somewhere, let me take another look.\")\n\n# Format a header range\nwks.format('A1:B1', {'textFormat': {'bold': True}})\n\n\n### Opening a Spreadsheet\n\ngspread offers flexible ways to open your spreadsheets:\n\npython\n# Open by title\nsh = gc.open('My poor gym results')\n\n# Open by key (from the spreadsheet's URL)\nsht1 = gc.open_by_key('0BmgG6nO_6dprdS1MN3d3MkdPa142WFRrdnRRUWl1UFE')\n\n# Open by full URL\nsht2 = gc.open_by_url('https://docs.google.com/spreadsheet/ccc?key=0Bm...FE&hl')\n\n\n### Reading Data\n\nYou can easily retrieve data from your worksheets:\n\npython\n# Get a single cell value by coordinates\nval = worksheet.cell(1, 2).value\n\n# Get all values from the first row\nvalues_list = worksheet.row_values(1)\n\n# Get all values from the first column\nvalues_list = worksheet.col_values(1)\n\n\n## Why Use gspread\n\ngspread simplifies the complex process of interacting with Google Sheets API, offering a Pythonic and intuitive interface. It eliminates the need to deal directly with low-level API calls, allowing developers to focus on their application logic. Its comprehensive features, including batch updates, flexible data retrieval, and robust authentication options, make it an excellent choice for anyone looking to integrate Google Sheets into their Python projects for data management, reporting, or automation.\n\n## Links\n\nFor more detailed information, examples, and to contribute, refer to the official resources:\n\n*   [GitHub Repository](https://github.com/burnash/gspread){:target=\"_blank\"}\n*   [Official Documentation](https://gspread.readthedocs.io/en/latest/){:target=\"_blank\"}","metrics":{"detailViews":0,"githubClicks":0},"dates":{"published":null,"modified":"2026-07-28T12:08:55.000Z"}}