Skip to main content

A package to access the google gmail api

Project description

Gmail API Python Library

This library provides an easy way to interact with the Gmail API using Python. With this library, you can send emails with attachments, authenticate with the Gmail API, and manage your email accounts.

Usage

To use this library, you'll need to have a Google API Console project with the Gmail API enabled. You can follow the steps outlined in the Gmail API Quickstart Guide to set up your project.

The library requires the following dependencies:

google-api-python-client
google-auth-httplib2
google-auth-oauthlib

you can install these dependencies using pip:

pip install -r requirements.txt

You'll also need to have a credentials.json file for your API project, which you can download from the API Console.

You can use the following code to get started with the Gmail API:

from darkgmailapi import GmailApi

# Create a GmailApi object
gmail = GmailApi(credentials="path/to/credentials.json", send_email="you@example.com", token_file="path/to/token.pickle", scope="https://mail.google.com/")

# Build a message to send
message = gmail.build_message(destination="recipient@example.com",
                               obj="Subject of the email",
                               body="Body of the email")

# Send the message
gmail.send_message("me", message.as_bytes())

You can also attach files to your emails using the add_attachment method:

# Add an attachment to the message
gmail.add_attachment(message, "path/to/attachment.pdf")

to search for emails, you can use the search method:

# Search for emails
emails = gmail.search("search query")
# returns a list of messages

to get the body of an email, you can use the read_message method:

# Read the data of an email
message_data = gmail.read_message(emails[0])
# returns a dictionary with the email data, in this format
# {
#   "from": "",
#   "to": "",
#   "subject": "",
#   "date": "",
#   "body_html": "",
#   "body_text": ""
# }

to delete an email, you can use the delete_message method:

# Delete an email
gmail.delete_message(emails[0])

to read and unread emails, you can use the mark_as_read and mark_as_unread methods:

# Mark an email as read
gmail.mark_as_read(emails[0])

# Mark an email as unread
gmail.mark_as_unread(emails[0])

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

darkgmailapi-0.0.4.tar.gz (17.6 kB view details)

Uploaded Source

Built Distribution

darkgmailapi-0.0.4-py3-none-any.whl (17.9 kB view details)

Uploaded Python 3

File details

Details for the file darkgmailapi-0.0.4.tar.gz.

File metadata

  • Download URL: darkgmailapi-0.0.4.tar.gz
  • Upload date:
  • Size: 17.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.1

File hashes

Hashes for darkgmailapi-0.0.4.tar.gz
Algorithm Hash digest
SHA256 0144571df2dc3ae1154ac7f37f66f044544d09619f0e8155694c79d68c671e6f
MD5 cb75f6b1303ffa19c1e78ccf495932c9
BLAKE2b-256 72ea0109761eb627ce3f8901b60be682e75485c85b2b395312677d8d5fd63bb4

See more details on using hashes here.

File details

Details for the file darkgmailapi-0.0.4-py3-none-any.whl.

File metadata

File hashes

Hashes for darkgmailapi-0.0.4-py3-none-any.whl
Algorithm Hash digest
SHA256 3594591fd358cc3f0a9b4560b9cdccd1dc1ed46270d690dfe147d373622bf746
MD5 2bdcf61dc3d0bff2c5beabf9b12e7917
BLAKE2b-256 eb2cce7e1b161531de491c2cebe58b19ee563c27cb867092e7cde0bc0c09be36

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page