sendgrid python
6.11.0
تتيح لك هذه المكتبة استخدام SendGrid Web API v3 بسرعة وسهولة عبر Python.
يوفر الإصدار 3.X.X+ من هذه المكتبة الدعم الكامل لجميع نقاط نهاية SendGrid Web API v3، بما في ذلك v3 /mail/send الجديد.
تمثل هذه المكتبة بداية مسار جديد لـ SendGrid. نريد أن تكون هذه المكتبة مدفوعة من قبل المجتمع وأن تقودها SendGrid. نحن بحاجة لمساعدتكم لتحقيق هذا الهدف. للمساعدة في التأكد من أننا نبني الأشياء الصحيحة بالترتيب الصحيح، نطلب منك إنشاء مشكلات وسحب الطلبات أو ببساطة التصويت لصالح المشكلات الحالية أو سحب الطلبات أو التعليق عليها.
إذا كنت بحاجة إلى مساعدة في استخدام SendGrid، فيرجى مراجعة مركز مساعدة دعم Twilio SendGrid.
يرجى تصفح بقية هذا الملف التمهيدي لمزيد من التفاصيل.
قم بتحديث بيئة التطوير باستخدام SENDGRID_API_KEY (مزيد من المعلومات هنا)، على سبيل المثال:
echo " export SENDGRID_API_KEY='YOUR_API_KEY' " > sendgrid.env
echo " sendgrid.env " >> .gitignore
source ./sendgrid.env يدعم SendGrid أيضًا ملف البيئة المحلية .env . انسخ أو أعد تسمية .env_sample إلى .env وقم بتحديث SENDGRID_API_KEY باستخدام مفتاحك.
قم بتعيين متغير البيئة مؤقتًا (يمكن الوصول إليه فقط أثناء جلسة cli الحالية):
set SENDGRID_API_KEY=YOUR_API_KEYقم بتعيين متغير البيئة بشكل دائم (يمكن الوصول إليه في جميع جلسات cli اللاحقة):
setx SENDGRID_API_KEY " YOUR_API_KEY " pip install sendgridفيما يلي الحد الأدنى من الكود المطلوب لإرسال بريد إلكتروني باستخدام /mail/send Helper (إليك مثال كامل):
import sendgrid
import os
from sendgrid . helpers . mail import *
sg = sendgrid . SendGridAPIClient ( api_key = os . environ . get ( 'SENDGRID_API_KEY' ))
from_email = Email ( "[email protected]" )
to_email = To ( "[email protected]" )
subject = "Sending with SendGrid is Fun"
content = Content ( "text/plain" , "and easy to do anywhere, even with Python" )
mail = Mail ( from_email , to_email , subject , content )
response = sg . client . mail . send . post ( request_body = mail . get ())
print ( response . status_code )
print ( response . body )
print ( response . headers ) يقوم مُنشئ Mail بإنشاء كائن تخصيص لك. فيما يلي مثال لكيفية إضافتها.
فيما يلي الحد الأدنى من الكود المطلوب لإرسال بريد إلكتروني بدون مساعد /mail/send (إليك مثال كامل):
import sendgrid
import os
sg = sendgrid . SendGridAPIClient ( api_key = os . environ . get ( 'SENDGRID_API_KEY' ))
data = {
"personalizations" : [
{
"to" : [
{
"email" : "[email protected]"
}
],
"subject" : "Sending with SendGrid is Fun"
}
],
"from" : {
"email" : "[email protected]"
},
"content" : [
{
"type" : "text/plain" ,
"value" : "and easy to do anywhere, even with Python"
}
]
}
response = sg . client . mail . send . post ( request_body = data )
print ( response . status_code )
print ( response . body )
print ( response . headers ) import sendgrid
import os
sg = sendgrid . SendGridAPIClient ( api_key = os . environ . get ( 'SENDGRID_API_KEY' ))
response = sg . client . suppression . bounces . get ()
print ( response . status_code )
print ( response . body )
print ( response . headers ) import sendgrid
import os
sg = sendgrid . SendGridAPIClient ( api_key = os . environ . get ( 'SENDGRID_API_KEY' ))
response = sg . client . _ ( "suppression/bounces" ). get ()
print ( response . status_code )
print ( response . body )
print ( response . headers )يرجى الاطلاع على مساعدنا لاستخدام خطاف الويب Inbound Parse الخاص بنا.
أمثلة على حالات استخدام واجهة برمجة التطبيقات الشائعة، مثل كيفية إرسال بريد إلكتروني باستخدام قالب المعاملات.
تم توثيق جميع التحديثات لهذه المكتبة في سجل التغيير والإصدارات الخاصة بنا.
نحن نشجع المساهمة في مكتباتنا (قد تحصل أيضًا على بعض الغنيمة الرائعة)، يرجى الاطلاع على دليل المساهمة الخاص بنا للحصول على التفاصيل.
روابط سريعة:
يرجى الاطلاع على دليل استكشاف الأخطاء وإصلاحها الخاص بنا لمعرفة مشكلات المكتبة الشائعة.
تتم صيانة sendgrid-python وتمويله بواسطة Twilio SendGrid, Inc.. الأسماء والشعارات الخاصة بـ sendgrid-python هي علامات تجارية مملوكة لشركة Twilio SendGrid, Inc.
إذا كنت بحاجة إلى الدعم، يرجى مراجعة مركز مساعدة دعم Twilio SendGrid.
رخصة معهد ماساتشوستس للتكنولوجيا (MIT)
