Unleash Your Inner Robot: Automate Gmail Attachments with Python!

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

import os
import pickle
import base64
from email.mime.multipart import MIMEMultipart
from email.mime.text import MIMEText
from email.mime.base import MIMEBase
from email import encoders

from google.auth.transport.requests import Request
from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError

SCOPES = ['https://www.googleapis.com/auth/gmail.send']

def authenticate_gmail():
    """Shows user how to authenticate with Gmail API and stores token.
    The file token.pickle stores the user's access and refresh tokens, and is
    created automatically when the authorization flow completes for the first
    time.
    """
    creds = None
    # Check if a token file already exists.
    if os.path.exists('token.pickle'):
        with open('token.pickle', 'rb') as token:
            creds = pickle.load(token)

    # If there are no (valid) credentials available, or they have expired,
    # let the user log in or refresh the existing token.
    if not creds or not creds.valid:
        if creds and creds.expired and creds.refresh_token:
            # If credentials are expired but we have a refresh token, try to refresh them.
            creds.refresh(Request())
        else:
            # Otherwise, initiate the full OAuth flow.
            flow = InstalledAppFlow.from_client_secrets_file(
                'credentials.json', SCOPES)
            # This line opens a browser for the user to authenticate.
            creds = flow.run_local_server(port=0)
        # Save the credentials for the next run, so we don't need to re-authenticate.
        with open('token.pickle', 'wb') as token:
            pickle.dump(creds, token)

    # Build the Gmail service object using the authenticated credentials.
    service = build('gmail', 'v1', credentials=creds)
    return service

def create_message_with_attachment(sender, to, subject, message_text, file_path):
    """Create a message for an email with an attachment."""
    message = MIMEMultipart() # MIMEMultipart allows us to combine different parts (text, attachment) into one email.
    message['to'] = to
    message['from'] = sender
    message['subject'] = subject

    # Attach the main body text of the email
    msg = MIMEText(message_text)
    message.attach(msg)

    # Attach the file
    try:
        with open(file_path, 'rb') as f: # Open the file in binary read mode ('rb')
            part = MIMEBase('application', 'octet-stream') # Create a new part for the attachment
            part.set_payload(f.read()) # Read the file's content and set it as the payload
        encoders.encode_base64(part) # Encode the file content to base64, which is standard for email attachments.

        # Extract filename from the provided path to use as the attachment's name.
        file_name = os.path.basename(file_path)
        part.add_header('Content-Disposition', 'attachment', filename=file_name)
        message.attach(part) # Attach the file part to the overall message.
    except FileNotFoundError:
        print(f"Error: Attachment file not found at '{file_path}'. Sending email without attachment.")
        # If the file isn't found, we'll still send the email body without the attachment.
        pass

    # Encode the entire message into base64 URL-safe format for the Gmail API.
    raw_message = base64.urlsafe_b64encode(message.as_bytes()).decode()
    return {'raw': raw_message}

def send_message(service, user_id, message):
    """Send an email message.

    Args:
        service: Authorized Gmail API service instance.
        user_id: User's email address. The special value "me" can be used to indicate the authenticated user.
        message: A dictionary containing the message to be sent, created by create_message_with_attachment.

    Returns:
        The sent message object if successful, None otherwise.
    """
    try:
        # Use the Gmail API's 'users().messages().send' method to send the email.
        sent_message = service.users().messages().send(userId=user_id, body=message).execute()
        print(f"Message Id: {sent_message['id']}")
        return sent_message
    except HttpError as error:
        print(f"An error occurred while sending the email: {error}")
        return None

def main():
    # 1. Authenticate with Gmail API
    service = authenticate_gmail()

    # 2. Define email details
    sender_email = "me"  # "me" refers to the authenticated user's email address
    recipient_email = "your-email@example.com" # !!! IMPORTANT: CHANGE THIS TO YOUR ACTUAL RECIPIENT'S EMAIL ADDRESS !!!
    email_subject = "Automated Daily Report - From Python!"
    email_body = (
        "Hello Team,\n\n"
        "Please find the attached daily report for your review. This email "
        "was automatically generated by our Python script.\n\n"
        "Best regards,\n"
        "Your Friendly Automation Bot"
    )

    # Define the attachment file.
    attachment_file_name = "daily_report.txt"
    # Create a dummy file for attachment if it doesn't exist.
    # This is useful for testing the script without needing to manually create a file.
    if not os.path.exists(attachment_file_name):
        with open(attachment_file_name, "w") as f:
            f.write("This is a dummy daily report generated by Python.\n")
            f.write("Current timestamp: " + os.popen('date').read().strip()) # Adds current date/time

    attachment_path = attachment_file_name # Make sure this file exists in the same directory, or provide a full path.

    # 3. Create the email message with the attachment
    message = create_message_with_attachment(
        sender_email, 
        recipient_email, 
        email_subject, 
        email_body, 
        attachment_path
    )

    # 4. Send the email using the authenticated service
    if message:
        send_message(service, sender_email, message)
        print("Email sent successfully!")
    else:
        print("Failed to create email message. Check file paths and content.")

if __name__ == '__main__':
    main()

import os
import pickle
import base64
from email.mime.multipart import MIMEMultipart
from email.mime.text import MIMEText
from email.mime.base import MIMEBase
from email import encoders

from google.auth.transport.requests import Request
from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError

SCOPES = ['https://www.googleapis.com/auth/gmail.send']

def authenticate_gmail():
    """Shows user how to authenticate with Gmail API and stores token.
    The file token.pickle stores the user's access and refresh tokens, and is
    created automatically when the authorization flow completes for the first
    time.
    """
    creds = None
    if os.path.exists('token.pickle'):
        with open('token.pickle', 'rb') as token:
            creds = pickle.load(token)

    if not creds or not creds.valid:
        if creds and creds.expired and creds.refresh_token:
            creds.refresh(Request())
        else:
            flow = InstalledAppFlow.from_client_secrets_file(
                'credentials.json', SCOPES)
            creds = flow.run_local_server(port=0)
        with open('token.pickle', 'wb') as token:
            pickle.dump(creds, token)

    service = build('gmail', 'v1', credentials=creds)
    return service

def create_message_with_attachment(sender, to, subject, message_text, file_path):
    """Create a message for an email with an attachment."""
    message = MIMEMultipart()
    message['to'] = to
    message['from'] = sender
    message['subject'] = subject

    msg = MIMEText(message_text)
    message.attach(msg)

    try:
        with open(file_path, 'rb') as f:
            part = MIMEBase('application', 'octet-stream')
            part.set_payload(f.read())
        encoders.encode_base64(part)

        file_name = os.path.basename(file_path)
        part.add_header('Content-Disposition', 'attachment', filename=file_name)
        message.attach(part)
    except FileNotFoundError:
        print(f"Error: Attachment file not found at '{file_path}'. Sending email without attachment.")
        pass

    raw_message = base64.urlsafe_b64encode(message.as_bytes()).decode()
    return {'raw': raw_message}

def send_message(service, user_id, message):
    """Send an email message.

    Args:
        service: Authorized Gmail API service instance.
        user_id: User's email address. The special value "me" can be used to indicate the authenticated user.
        message: A dictionary containing the message to be sent.

    Returns:
        The sent message object if successful, None otherwise.
    """
    try:
        sent_message = service.users().messages().send(userId=user_id, body=message).execute()
        print(f"Message Id: {sent_message['id']}")
        return sent_message
    except HttpError as error:
        print(f"An error occurred while sending the email: {error}")
        return None

def main():
    service = authenticate_gmail()

    sender_email = "me"
    recipient_email = "your-email@example.com" # !!! IMPORTANT: CHANGE THIS TO YOUR ACTUAL RECIPIENT'S EMAIL ADDRESS !!!
    email_subject = "Automated Daily Report - From Python!"
    email_body = (
        "Hello Team,\n\n"
        "Please find the attached daily report for your review. This email "
        "was automatically generated by our Python script.\n\n"
        "Best regards,\n"
        "Your Friendly Automation Bot"
    )

    attachment_file_name = "daily_report.txt"
    if not os.path.exists(attachment_file_name):
        with open(attachment_file_name, "w") as f:
            f.write("This is a dummy daily report generated by Python.\n")
            f.write("Current timestamp: " + os.popen('date').read().strip())

    attachment_path = attachment_file_name

    message = create_message_with_attachment(
        sender_email, 
        recipient_email, 
        email_subject, 
        email_body, 
        attachment_path
    )

    if message:
        send_message(service, sender_email, message)
        print("Email sent successfully!")
    else:
        print("Failed to create email message. Check file paths and content.")

if __name__ == '__main__':
    main()