Google Authentication Library for OAuth 2.0

1.3.0 · active · verified Sat Mar 28

A Python library that provides OAuth 2.0 support for the google-auth library, enabling secure authentication for Google APIs. Current version: 1.3.0, released on February 27, 2026. Maintained with regular updates.

Warnings

breaking PKCE is enabled by default in version 1.0.0 and later.
Fix: Ensure your application supports PKCE or adjust your implementation accordingly.
breaking Deprecated OOB code removed in version 1.0.0.
Fix: Update your application to use supported redirect URIs.
gotcha Ensure 'client_secrets.json' is in the correct directory to avoid FileNotFoundError.
Fix: Place 'client_secrets.json' in the same directory as your script or provide the correct path.
gotcha Running the script without internet access will cause the OAuth flow to fail.
Fix: Ensure your machine has internet access during the OAuth flow.
gotcha Using an outdated version of google-auth-oauthlib may lead to compatibility issues.
Fix: Upgrade to the latest version using 'pip install --upgrade google-auth-oauthlib'.

Install

pip install google-auth-oauthlib Install google-auth-oauthlib

Imports

InstalledAppFlow
```
from google_auth_oauthlib.flow import InstalledAppFlow
```
Ensure correct import path to avoid ImportError.

Quickstart

A complete example demonstrating OAuth 2.0 authentication and accessing Google Drive API to list files.

import os
from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build

# Set up the OAuth 2.0 flow
flow = InstalledAppFlow.from_client_secrets_file(
    'client_secrets.json',
    scopes=['https://www.googleapis.com/auth/drive.readonly']
)

# Run the flow to get credentials
credentials = flow.run_local_server(port=0)

# Build the service
service = build('drive', 'v3', credentials=credentials)

# Call the Drive API
results = service.files().list(pageSize=10, fields='files(id, name)').execute()
items = results.get('files', [])

if not items:
    print('No files found.')
else:
    print('Files:')
    for item in items:
        print(f'{item['name']} ({item['id']})')

view raw JSON →