A unofficial high level Python API wrapper for some of the productivity based Google APIs, that is focused on simplicity.

dermasmid dermasmid Last update: Feb 05, 2024

Google Workspace

Google Workspace is a high level unofficial API wrapper for some of the productivity related Google API's. This library has for now only implemented a client for Gmail, I hope to add Drive and much more in the near future.

Installation

You can install from pypi:

pip install -U google-workspace

Or get the latest updates (Not recommended for production):

pip install -U git+https://github.com/dermasmid/google-workspace.git

Documentation

Take a look at the full documentation here https://google-workspace.readthedocs.io/

Getting project credentials

You need to get a client secret file from the google console and you need to enable the api you want to use, just Google it.

After you saved the credentials json file to your workdir - you are all set!

Quick start's

Here you can see a few samples to get a feel of whats ahead.

Authenticate on your local machine

This snippet will run a authentication flow using the local_oauth method.

import google_workspace

service = google_workspace.service.GoogleService(
    api="gmail",
    session="my-gmail",
    client_secrets="path/to/secrets/file"
    )
service.local_oauth()

gmail_client = google_workspace.gmail.GmailClient(service=service)
print(gmail_client.email_address)

Authenticate a remote user

This snippet will run a authentication flow using the url_oauth method.

import google_workspace

service = google_workspace.service.GoogleService(
    api="gmail",
    session="my-gmail",
    client_secrets="path/to/secrets/file"
    )

service.url_oauth(
    server_host="yourdomain.com",
    block=True
    )

gmail_client = google_workspace.gmail.GmailClient(service=service)
print(gmail_client.email_address)

Retrieve messages

This snippet will retrieve all messages from the inbox, print them to the console, mark them as read, and reply with a message saying "Hi!".

import google_workspace

gmail_client = google_workspace.gmail.GmailClient()

for message in gmail_client.get_messages("inbox"):
    print(message)
    message.mark_read()
    message.reply("Hi!")

Send html email with attachments

This snippet will send a html email with attachments and then delete it from your sent messages.

import google_workspace

gmail_client = google_workspace.gmail.GmailClient()
sent_message = gmail_client.send_message(
    to="[email protected]",
    subject="This is fun!",
    html="<b>HTML here</b>",
    attachments=["image.png", "doc.pdf"]
    )
gmail_client.delete_message(sent_message.get("id"))

Forward incoming messages

This snippet will forward all incoming messages which have "python" in thier subject.

import google_workspace

gmail_client = google_workspace.gmail.GmailClient()

def message_filter(history):
    return "python" in history.message.subject

@gmail_client.on_message(labels="inbox", filters=[message_filter])
def handle_message(history):
    history.message.forward(to="[email protected]")

Feedback and contributing

This library is very focused on being easy and fun to use, so if you find something that you think can be improved please open an issue or even better, a PR, thank you!

Subscribe to our newsletter