發送到應用程式的電子郵件是含 MIME 資料的 HTTP 要求。如要處理內送電子郵件,請將電子郵件地址與應用程式設定中的指令碼處理常式建立關聯,然後將處理常式加在應用程式的程式碼中。
內送電子郵件會產生 HTTP 要求,系統會將這些要求傳遞到適當的指令碼。您的預設服務必須要有處理內收電子郵件的指令碼。
如需進一步瞭解郵件服務,請參閱郵件 API 總覽。
設定以應用程式接收電子郵件
建立新應用程式時,預設會停用內送電子郵件。如要啟用內送電子郵件,您必須修改預設服務中的 app.yaml
檔案。
新增一個會啟用內送電子郵件服務的
inbound_services
區段。 例如:若未在設定檔中新增這個區段,以利啟用內送電子郵件, 就會停用內送電子郵件功能,因此會忽略發送至應用程式的電子郵件。
新增對應,為網址對應的電子郵件地址與指令碼處理常式建立關聯。
如果是預設服務,用來接收電子郵件的電子郵件地址格式如下:
[STRING]@[Google Cloud project ID].appspotmail.com
如果不是預設服務,電子郵件地址的格式如下:
[STRING]@[servicename]-dot-[Google Cloud project ID].appspotmail.com
系統會使用下列網址,以 HTTP POST 要求的形式將電子郵件傳送至應用程式,其中 [ADDRESS] 是完整的電子郵件地址,包括網域名稱:
/_ah/mail/[ADDRESS]
如要在應用程式中處理內送電子郵件,請在
app.yaml
檔案中將電子郵件網址對應至處理常式:在上述範例中,
/_ah/mail/.+
會比對所有傳送至應用程式的電子郵件地址。如要為不同電子郵件地址設定多個處理常式,請參閱下列範例:系統將根據此清單,從頭到尾一一比對內送電子郵件的網址; 如果電子郵件網址符合一個以上的格式, 系統會執行第一個相符的處理常式。這樣您所加入的最後一個對應項目就可以是「catchall」。處理常式會在預設模組 (或應用程式版本) 中執行。
處理傳入電子郵件
Python SDK 定義了 InboundMailHandler
,這是用於處理來信的 webapp 類別。InboundMailHandler
位於
google.appengine.ext.webapp.mail_handlers
套件中。
如何使用 InboundMailHandler
:
- 建立
InboundMailHandler
的子類別,並覆寫receive()
方法。 - 使用類別
receive()
的引數呼叫InboundEmailMessage
方法 (這是以 Python SDK 定義的)。
舉例來說,您可以建立 InboundEmailMessage
的執行個體,如下所示:
InboundMailHandler
包含 mapping()
便利類別方法,可將所有傳入的電子郵件地址與郵件處理常式配對,當然您也可以在編碼的任何 InboundMailHandler
子類別上呼叫該方法:
InboundEmailMessage
物件 (本例中為 mail_message
) 包含電子郵件訊息。這個方法會傳回訊息中的主體。bodies()
如果您在沒有引數的情況下呼叫 bodies()
,系統會傳回疊代器,先產生 HTML 內文,再產生純文字內文。如只要 HTML 或純文字,可以將引數傳遞至 bodies()
:
InboundEmailMessage
物件包含可存取其他訊息欄位的屬性:
subject
包含郵件主旨。sender
是寄件者的地址,例如"Nobody <nobody@example.com>"
。to
是以半形逗號分隔的清單,內容註明電子郵件主要收件人,例如"Joe <joe@example.com>, Bill <bill@example.com>"
。cc
包含以半形逗號分隔的副本收件者清單,例如"Joe <joe@example.com>, Bill <bill@example.com>"
。date
會傳回電子郵件日期。attachments
是Attachment
物件的清單,可能沒有內容。original
是完整電子郵件,內容包括其他欄位沒有顯示的資料,例如電子郵件的標頭,如 Pythonemail.message.Message
。
使用本機開發伺服器模擬內送電子郵件
設定好處理內送電子郵件的應用程式之後, 就可以使用開發伺服器主控台模擬內送電子郵件:
- 前往 http://localhost:8080/console 並選取「以管理員身分登入」,以管理員身分存取開發伺服器。
- 在開發伺服器的導航介面中按一下 [傳入的郵件]。
填妥出現的表單,然後按一下 [傳送電子郵件]。
如需詳細資訊,包括如何執行開發伺服器,請參閱 Python 開發伺服器。