{ "componentChunkName": "component---src-templates-blog-template-js", "path": "/blog/introducing-gmail-wrapper", "result": {"data":{"markdownRemark":{"html":"

If you’ve ever had to read or write emails using the Official Gmail Python SDK, then you know it is a pain for multiple reasons:

\n\n

We use Gmail for several automated tasks at Loadsmart, and to overcome these difficulties we developed gmail-wrapper, a Python library that encapsulates the hard parts of the official SDK and provides an easier API.\nIt was a closed project used only internally, but now we decided to make it the first Loadsmart open-sourced Python package.\nHere are some comparisons with the official SDK:

\n

Authenticate

\n

For both official SDK and Gmail Wrapper, you will use the service account key with a refresh token.\nIt is a JSON file like this:

\n
{\n  \"token\": \"...\", \"client_id\": \"...\", \"client_secret\": \"...\", \"token_uri\": \"...\", \"refresh_token\": \"...\"\n}
\n

Official SDK

\n
from google.auth.transport.requests import Request\nfrom google.oauth2.credentials import Credentials\nfrom googleapiclient import discovery\n\ncredentials = Credentials(\n    token=token,\n    refresh_token=refresh_token,\n    client_id=client_id,\n    client_secret=client_secret,\n    token_uri=token_uri,\n    scopes=[\"https://www.googleapis.com/auth/gmail.modify\"],\n)\ncredentials.refresh(Request())\nreturn discovery.build(\"gmail\", \"v1\", credentials=credentials)
\n

Gmail Wrapper

\n
from gmail_wrapper import GmailClient\n\nclient = GmailClient(\n    \"john.doe@example.org\",\n    secrets_json_string=\"{...}\", # Generated on your Google console\n    scopes=[GmailClient.SCOPE_MODIFY] # Scope constants out of the box\n)
\n

List messages

\n

Official SDK

\n
messages = client.users().messages().list(userId=\"john.doe@example.org\", q=\"receipts\", maxResult=10).execute()\n# messages is now a dict with previews\nfor preview in messages[\"messages\"]:\n    message = client.users().messages().get(userId=\"john.doe@example.org\", id=preview[\"id\"])\n    for header in message[\"payload\"][\"headers\"]:\n        if header[\"name\"] == \"Subject\":\n            print(header[\"value\"])
\n

Gmail Wrapper

\n
messages = client.get_messages(query=\"receipts\", limit=10)\nfor message in messages:\n    print(message.subject) # Gmail Wrapper will automatically lazy-load the properties as you need them
\n

How can I use it?

\n

From the examples you could have a taste of the official SDK difficulties and how a higher-level library can help (We did not even mention composing messages, replying to messages, or reading attachments).

\n

If you are interested in learning more about this package there is detailed documentation on the GitHub repository.

\n

To install, you already guess it: pip install gmail-wrapper

\n

Of course the initial build of Gmail Wrapper has limitations.\nFor example, sending emails with attachments or authenticating with non-renewable tokens is not possible.\nHowever, these are solvable issues that can easily be addressed by the community.\nSo please don’t forget to contribute if you find any bugs or if you think something can be improved!\nWe will be more than happy to review your suggestions or pull-requests.

","excerpt":"If you’ve ever had to read or write emails using the Official Gmail Python SDK, then you know it is a pain for multiple reasons: It is verbose, using dozens of chained objects like It is not intuitive (How do I authenticate? How do I read my messages? How do I send a message? I don’t know...) It uses plain dictionaries as the default response, regardless of the number of classes used (What are the fields? I’ll have to look the docs again) We use Gmail for several automated tasks at Loadsmart…","frontmatter":{"date":"July 22, 2020","path":"/blog/introducing-gmail-wrapper","title":"Introducing Gmail Wrapper","comments":true,"author":"Luiz Rosa"},"fields":{"readingTime":{"text":"3 min read"}}}},"pageContext":{}}, "staticQueryHashes": ["63159454"]}