simplegmail下载 - simplegmail源代码下载

SimpleGmail

Python中的一个简单的Gmail API客户端，用于应用程序。

目前支持行为：

发送HTML消息
发送带有附件的消息
通过您的Gmail帐户签名发送消息
使用Gmail的搜索功能的完整套件检索消息
通过附件检索消息和下载附件
修改消息标签（包括标记为读取/未读，重要/不重要，明星/未经标记，垃圾/trash，收件箱/存档）

入门

唯一需要的设置是从Google下载OAuth 2.0客户端ID文件，该文件将授权您的应用程序。

可以在以下网址完成：https：//console.developers.google.com/apis/credentials。对于那些没有为Google API创建凭据的人，单击上面的链接（并登录到适当的帐户），

选择/创建此身份验证的项目（如果创建一个新项目，请确保配置OAuth同意屏幕；您只需要设置应用程序名称）
单击“仪表板”选项卡，然后单击“启用API和服务”。搜索Gmail并启用。
单击“凭据”选项卡，然后“创建凭据”>“ OAUTH客户端ID”。
选择这是什么样的应用程序，并给它一个令人难忘的名称。填写凭据的所有必要信息（例如，如果选择“ Web应用程序”，请确保添加授权的重定向URI。请参阅https://developers.google.com/identity/protocols/oauth2，以获取更多信息）。
返回凭据屏幕，单击您刚刚创建的凭据旁边的下载图标，以将其作为JSON对象下载。
将此文件另存为“ client_secret.json”，然后将其放在应用程序的根目录中。（如果您选择否则将其名称命名，则Gmail类以该文件的名称进行参数。）

您第一次创建Gmail类的新实例时，将打开一个浏览器窗口，您会被要求3S授予该应用程序的权限。这将在名为“ gmail-token.json”的文件中保存一个访问令牌，只需要一次。

你现在很好！

关于身份验证方法的注意：我选择不使用用户名password身份验证（通过IMAP/SMTP），因为使用Google的授权既更安全，又避免与Google的许多安全措施发生冲突。

安装

使用pip安装（Python3）。

pip3 install simplegmail

用法

发送一个简单的消息：

 from simplegmail import Gmail

gmail = Gmail () # will open a browser window to ask you to log in and authenticate

params = {
  "to" : "[email protected]" ,
  "sender" : "[email protected]" ,
  "subject" : "My first email" ,
  "msg_html" : "<h1>Woah, my first email!</h1><br />This is an HTML email." ,
  "msg_plain" : "Hi n This is a plain text email." ,
  "signature" : True  # use my account signature
}
message = gmail . send_message ( ** params )  # equivalent to send_message(to="[email protected]", sender=...)

发送带有附件的消息，CC，BCC字段：

 from simplegmail import Gmail

gmail = Gmail ()

params = {
  "to" : "[email protected]" ,
  "sender" : "[email protected]" ,
  "cc" : [ "[email protected]" ],
  "bcc" : [ "[email protected]" , "[email protected]" ],
  "subject" : "My first email" ,
  "msg_html" : "<h1>Woah, my first email!</h1><br />This is an HTML email." ,
  "msg_plain" : "Hi n This is a plain text email." ,
  "attachments" : [ "path/to/something/cool.pdf" , "path/to/image.jpg" , "path/to/script.py" ],
  "signature" : True  # use my account signature
}
message = gmail . send_message ( ** params )  # equivalent to send_message(to="[email protected]", sender=...)

这不是简单的！

检索消息：

 from simplegmail import Gmail

gmail = Gmail ()

# Unread messages in your inbox
messages = gmail . get_unread_inbox ()

# Starred messages
messages = gmail . get_starred_messages ()

# ...and many more easy to use functions can be found in gmail.py!

# Print them out!
for message in messages :
    print ( "To: " + message . recipient )
    print ( "From: " + message . sender )
    print ( "Subject: " + message . subject )
    print ( "Date: " + message . date )
    print ( "Preview: " + message . snippet )
    
    print ( "Message Body: " + message . plain )  # or message.html

标记消息：

 from simplegmail import Gmail

gmail = Gmail ()

messages = gmail . get_unread_inbox ()

message_to_read = messages [ 0 ]
message_to_read . mark_as_read ()

# Oops, I want to mark as unread now
message_to_read . mark_as_unread ()

message_to_star = messages [ 1 ]
message_to_star . star ()

message_to_trash = messages [ 2 ]
message_to_trash . trash ()

# ...and many more functions can be found in message.py!

更改消息标签：

 from simplegmail import Gmail

gmail = Gmail ()

# Get the label objects for your account. Each label has a specific ID that 
# you need, not just the name!
labels = gmail . list_labels ()

# To find a label by the name that you know (just an example):
finance_label = list ( filter ( lambda x : x . name == 'Finance' , labels ))[ 0 ]

messages = gmail . get_unread_inbox ()

# We can add/remove a label
message = messages [ 0 ]
message . add_label ( finance_label ) 

# We can "move" a message from one label to another
message . modify_labels ( to_add = labels [ 10 ], to_remove = finance_label )

# ...check out the code in message.py for more!

下载附件：

 from simplegmail import Gmail

gmail = Gmail ()

messages = gmail . get_unread_inbox ()

message = messages [ 0 ]
if message . attachments :
    for attm in message . attachments :
        print ( 'File: ' + attm . filename )
        attm . save ()  # downloads and saves each attachment under it's stored
                     # filename. You can download without saving with `attm.download()`

检索消息（高级，查询！）：

 from simplegmail import Gmail
from simplegmail . query import construct_query

gmail = Gmail ()

# Unread messages in inbox with label "Work"
labels = gmail . list_labels ()
work_label = list ( filter ( lambda x : x . name == 'Work' , labels ))[ 0 ]

messages = gmail . get_unread_inbox ( labels = [ work_label ])

# For even more control use queries:
# Messages that are: newer than 2 days old, unread, labeled "Finance" or both "Homework" and "CS"
query_params = {
    "newer_than" : ( 2 , "day" ),
    "unread" : True ,
    "labels" :[[ "Work" ], [ "Homework" , "CS" ]]
}

messages = gmail . get_messages ( query = construct_query ( query_params ))

# We could have also accomplished this with
# messages = gmail.get_unread_messages(query=construct_query(newer_than=(2, "day"), labels=[["Work"], ["Homework", "CS"]]))
# There are many, many different ways of achieving the same result with search.

检索消息（更高级，带有更多查询！）：

 from simplegmail import Gmail
from simplegmail . query import construct_query

gmail = Gmail ()

# For even more control use queries:
# Messages that are either:
#   newer than 2 days old, unread, labeled "Finance" or both "Homework" and "CS"
#     or
#   newer than 1 month old, unread, labeled "Top Secret", but not starred.

labels = gmail . list_labels ()

# Construct our two queries separately
query_params_1 = {
    "newer_than" : ( 2 , "day" ),
    "unread" : True ,
    "labels" :[[ "Finance" ], [ "Homework" , "CS" ]]
}

query_params_2 = {
    "newer_than" : ( 1 , "month" ),
    "unread" : True ,
    "labels" : [ "Top Secret" ],
    "exclude_starred" : True
}

# construct_query() will create both query strings and "or" them together.
messages = gmail . get_messages ( query = construct_query ( query_params_1 , query_params_2 ))