{"id":21535,"library":"llama-index-readers-google","title":"LlamaIndex Google Readers","description":"A collection of Google data connector readers for LlamaIndex, supporting Google Drive, Gmail, Google Calendar, Google Sheets, and Google Docs. Currently at version 0.7.2, with frequent updates following the LlamaIndex release cadence.","status":"active","version":"0.7.2","language":"python","source_language":"en","source_url":"https://github.com/run-llama/llama_index/tree/main/llama-index-integrations/readers/llama-index-readers-google","tags":["llama-index","google","drive","gmail","calendar","sheets","reader"],"install":[{"cmd":"pip install llama-index-readers-google","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Required for Google API authentication and service construction","package":"google-api-python-client","optional":false},{"reason":"Transitive dependency for OAuth2","package":"google-auth-httplib2","optional":false},{"reason":"Used for OAuth2 flow","package":"google-auth-oauthlib","optional":false}],"imports":[{"note":"Old import path was nested under google_drive, now consolidated under google","wrong":"from llama_index.readers.google_drive import GoogleDriveReader","symbol":"GoogleDriveReader","correct":"from llama_index.readers.google import GoogleDriveReader"},{"note":"","wrong":null,"symbol":"GmailReader","correct":"from llama_index.readers.google import GmailReader"},{"note":"","wrong":null,"symbol":"GoogleCalendarReader","correct":"from llama_index.readers.google import GoogleCalendarReader"},{"note":"","wrong":null,"symbol":"GoogleSheetsReader","correct":"from llama_index.readers.google import GoogleSheetsReader"}],"quickstart":{"code":"import os\nfrom llama_index.readers.google import GoogleDriveReader\n\n# Set your Google OAuth credentials path or rely on default discovery\nreader = GoogleDriveReader(\n    folder_id=\"<your-folder-id>\",\n    service_account_key_path=os.environ.get(\"GOOGLE_SERVICE_ACCOUNT_KEY\", \"\"),\n)\ndocuments = reader.load_data()","lang":"python","description":"Initialize GoogleDriveReader with folder ID and optional service account key. Falls back to OAuth flow if no key provided."},"warnings":[{"fix":"Change imports to 'from llama_index.readers.google import ...'","message":"In v0.5.0, the import paths were restructured. Previously readers were under 'llama_index.readers.google_drive', 'llama_index.readers.gmail', etc. Now all Google readers are under 'llama_index.readers.google'. Update imports accordingly.","severity":"breaking","affected_versions":"<0.5.0"},{"fix":"Use 'credentials' parameter with a GoogleOAuth2Credentials object instead.","message":"The 'service_account_key_path' parameter in GoogleDriveReader is deprecated in favor of 'credentials'.","severity":"deprecated","affected_versions":">=0.6.0"},{"fix":"Use the folder ID from the URL: 'https://drive.google.com/drive/folders/<folder-id>'","message":"Folder ID for GoogleDriveReader is case-sensitive and must be the folder's ID (not name). Extracting from URL can be error-prone.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Update import to 'from llama_index.readers.google import GoogleDriveReader'","cause":"Import path changed in v0.5.0. Old code uses deprecated path.","error":"ModuleNotFoundError: No module named 'llama_index.readers.google_drive'"},{"fix":"Set GOOGLE_APPLICATION_CREDENTIALS environment variable to point to a JSON service account key, or run the OAuth flow.","cause":"Missing or invalid Google credentials. Either OAuth token or service account key not provided.","error":"google.auth.exceptions.DefaultCredentialsError: Could not automatically determine credentials."},{"fix":"Upgrade to latest: pip install --upgrade llama-index-readers-google","cause":"Likely using a very old version (<0.4.0) where the method was named 'load_documents'.","error":"AttributeError: 'GoogleDriveReader' object has no attribute 'load_data'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}