gp_wrapper v=0.9.9

A Google Photos API wrapper library

• Official API is already supported

What does this package offer?

Support for all of the official API and more convenience function as well. A-lot of well defined API inspired Classes and Enums to simplify the usage.

• GooglePhotos class - wrapper over authenticated HTTP session
• Album Class - handles all of the global and instance methods for an Album
• MediaItem Class - handles all of the global and instance methods for MediaItem
• Enums: RequestType, HeaderType, MimeType, PositionType, EnrichmentType, MediaItemMaskTypes, AlbumMaskType, RelativeItemType, StatusCode
• Classes: SimpleMediaItem, NewMediaItem, AlbumPosition, Status, MediaItemResult, MediaMetadata, ContributorInfo

Quick Start

1. Create a Google Cloud Console project
2. Enable google photos API here
3. Fill information here
   1. Fill application name and detail
   2. Apply scopes
      1. https://www.googleapis.com/auth/photoslibrary,
      2. https://www.googleapis.com/auth/photoslibrary.appendonly
      3. https://www.googleapis.com/auth/photoslibrary.sharing
      4. https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata
   3. Add a google account as a Test User which will be able to use you project as an 'end user'
4. Extract relevant data for client_secrets.json
5. Install:
   • From PyPI: pip install gp_wrapper or uv add gp_wrapper
   • Local development (this repo): uv sync (runtime) or uv sync --group dev (mypy, pylint, pytest, quickpub, …)
   • Publish a new version: bump VERSION in publish.py, then uv run python publish.py (quickpub 4.1.2+; needs .pypirc)
6. See example here