Skip to main content

LlamaIndex Integration: Google Readers

Effortlessly incorporate Google-based data loaders into your Python workflow using LlamaIndex. It now supports more advanced operations through the implementation of ResourcesReaderMixin and FileSystemReaderMixin. Unlock the potential of various readers to enhance your data loading capabilities, including:

  • Google Calendar
  • Google Chat
  • Google Docs
  • Google Drive
  • Gmail
  • Google Keep
  • Google Maps
  • Google Sheets

Installation

pip install llama-index-readers-google

Authentication

You will need a credentials.json file from Google Cloud to interact with Google Services. To get this file, follow these steps:

  • Create a new project in the Google Cloud Console
  • Go to APIs & Services -> Library and search for the API you want, e.g. Gmail
  • Go to APIs & Services -> Credentials and create a new OAuth client ID
    • Application type: Web application
    • Authorized redirect URIs: http://localhost:8080/ (the last slash seems important)
  • Go to APIs & Services -> OAuth consent screen and make the app external, which allows you to connect your personal Google data once you explicitly add yourself as an allowed test user
  • Download the credentials JSON file from this screen and save it as credentials.json in the root of your project

See this example for a sample of code that successfully authenticates with Gmail once you have the credentials.json file.

Examples

Google Drive Reader

from llama_index.readers.google import GoogleDriveReader

# Initialize the reader
reader = GoogleDriveReader(
    folder_id="folder_id",
    service_account_key="[SERVICE_ACCOUNT_KEY_JSON]",
)

# Load data
documents = reader.load_data()

# List resources in the drive
resources = reader.list_resources()

# Get information about a specific resource
resource_info = reader.get_resource_info("file.txt")

# Load a specific resource
specific_doc = reader.load_resource("file.txt")

# Read file content directly
file_content = reader.read_file_content("path/to/file.txt")

print(f"Loaded {len(documents)} documents")
print(f"Found {len(resources)} resources")
print(f"Resource info: {resource_info}")
print(f"Specific document: {specific_doc}")
print(f"File content length: {len(file_content)} bytes")

Google Docs Reader

from llama_index.readers.google import GoogleDocsReader

# Specify the document IDs you want to load
document_ids = ["<document_id>"]

# Load data from Google Docs
documents = GoogleDocsReader().load_data(document_ids=document_ids)

Google Sheets Reader (Documents and Dataframes)

from llama_index.readers.google import GoogleSheetsReader

# Specify the list of sheet IDs you want to load
list_of_sheets = ["spreadsheet_id"]

# Create a Google Sheets Reader instance
sheets_reader = GoogleSheetsReader()

# Load data into Pandas in Data Classes of choice (Documents or Dataframes)
documents = sheets.load_data(list_of_sheets)
dataframes = sheets_reader.load_data_in_pandas(list_of_sheets)

Integrate these readers seamlessly to efficiently manage and process your data within your Python environment, providing a robust foundation for your data-driven workflows with LlamaIndex.

Google Maps Text Search Reader

from llama_index.readers.google import GoogleMapsTextSearchReader
from llama_index.core import VectorStoreIndex

loader = GoogleMapsTextSearchReader()
documents = loader.load_data(
    text="I want to eat quality Turkish food in Istanbul",
    number_of_results=160,
)


index = VectorStoreIndex.from_documents(documents)
index.query("Which Turkish restaurant has the best reviews?")

Google Chat Reader

from llama_index.readers.google import GoogleChatReader
from llama_index.core import VectorStoreIndex

space_names = ["<CHAT_ID>"]
chatReader = GoogleChatReader()
docs = chatReader.load_data(space_names=space_names)
index = VectorStoreIndex.from_documents(docs)
query_eng = index.as_query_engine()
print(query_eng.query("What was this conversation about?"))

Metadata

Release files for llama-index-readers-google 0.9.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for llama-index-readers-google 0.9.0
File Size Uploaded Provenance Actions
llama_index_readers_google-0.9.0.tar.gz 23.3 kB Without provenance Details for llama_index_readers_google-0.9.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for llama-index-readers-google 0.9.0
File Interpreter ABI Platform Actions
llama_index_readers_google-0.9.0-py3-none-any.whl Python 3 none any Details for llama_index_readers_google-0.9.0-py3-none-any.whl

Total release size: 57.8 kB

Release files / llama_index_readers_google-0.9.0.tar.gz

Download URL llama_index_readers_google-0.9.0.tar.gz
Size 23.3 kB
Tags Source
SHA-256 checksum
How to use checksums
5883d2d66e2f00ec02d28c29fe65ec91b2618bfbaf01f79ceb947c5e5e9ffbe7
BLAKE2b-256 checksum
How to use checksums
8a392570a9022308b78577d6ac8baea09756a43c9b0156b13ce305efe930fb13
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / llama_index_readers_google-0.9.0-py3-none-any.whl

Download URL llama_index_readers_google-0.9.0-py3-none-any.whl
Size 34.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e3ae2494d5c53a8644845ecfc65970d7f64c84f96e22b0bdbb80e54796af9ec2
BLAKE2b-256 checksum
How to use checksums
2c1dc321e224b0630c7dbc45ce2895f1ceb4834e0f6469fb77a233849ab6119e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for llama-index-readers-google 0.9.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.9.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page